Llistat de projectes
projects:projects.readhttps://api.holded.com/api/v2/projectsRetorna una llista paginada de projectes del teu compte.
Paràmetres
Paràmetres de consulta
stringopcionalCursor opac per a la paginació. Utilitza el valor retornat a la resposta anterior
integeropcional= 50Nombre màxim de projectes a retornar per pàgina
stringopcionalFiltra projectes per estat. Utilitza «active» o «in_progress» per obtenir només els projectes actius
"active""in_progress""completed""cancelled""waiting""budgeted"Petició
import requests
url = "https://api.holded.com/api/v2/projects?cursor=value&limit=50&status=value"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respostes
Resposta
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"description": "string",
"type": "string",
"icon": "string",
"color": "string",
"key": "string",
"scope": "string",
"users": {},
"contact_id": "string",
"contact_name": "string",
"start_date": "string",
"due_date": "string",
"tags": [
"string"
],
"archived": false,
"status": 0,
"number_of_tasks": 0,
"completed_tasks": 0,
"billable": false
}
],
"has_more": false,
"cursor": "string"
}Respostes exitoses
200Llistat de projectesapplication/jsonUnique identifier
Project name
Project description
Project type
Project icon
Project color
Project key
Project scope
Project members keyed by user ID
Contact ID
Contact name
Start date, formatted according to the account's date settings
Due date, formatted according to the account's date settings
Tags
Whether the project is archived
Project status
Total number of tasks
Number of completed tasks
Whether the project is billable
Whether there are more items on the next page
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Respostes d'error
401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json429Límit de sol·licituds exceditapplication/json