GET
Llistat global de registres de temps d'empleats
Scope:
team:time-tracking.readhttps://api.holded.com/api/v2/employee-timesRetorna una llista paginada de tots els registres de temps d'empleats del teu compte.
Paràmetres
Paràmetres de consulta
cursor
stringopcionalCursor opac per a la paginació. Utilitza el valor retornat a la resposta anterior per obtenir la pàgina següent.
limit
integeropcional= 50Nombre màxim de registres a retornar per pàgina
Petició
python
import requests
url = "https://api.holded.com/api/v2/employee-times?cursor=page:2&limit=50"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respostes
Resposta
json
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"employee_id": "507f1f77bcf86cd799439012",
"employee_name": "string",
"date": "2024-01-15T10:30:00Z",
"start_at": "2024-01-15T10:30:00Z",
"end_at": "2024-01-15T10:30:00Z",
"duration": 0,
"status": "string",
"approved": false,
"approved_by": "string",
"approved_at": "2024-01-15T10:30:00Z"
}
],
"has_more": false,
"cursor": "string"
}Respostes exitoses
200Llistat de registres de temps d'empleatsapplication/jsonobject
items[]object[]required
idstringrequired
Unique identifier
employee_idstringrequired
Employee ID
employee_namestring | nullrequired
Employee display name
datestring<date-time> | nullrequired
Date of the time entry in ISO 8601
start_atstring<date-time>required
Start time in ISO 8601
end_atstring<date-time> | nullrequired
End time in ISO 8601
durationintegerrequired
Duration in seconds
statusstringrequired
Tracker status (running, done)
approvedbooleanrequired
Whether the entry is approved
approved_bystring | nullrequired
User ID who approved
approved_atstring<date-time> | nullrequired
Approval date in ISO 8601
has_morebooleanrequired
Whether there are more items on the next page
cursorstring | nulloptional
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