agency-time
GET /v1/agency/time/report
Time reporting for a period, by person, client and project.
Authentification
Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.
Où insérer l'ID de votre organisation
Cet point de terminaison prend org_id comme paramètre de requête. Omettez-le et l'appel couvrira l'ensemble de votre sous-arbre de location ; envoyez-le pour restreindre l'appel à une seule organisation.
L'identifiant de votre organisation se trouve sur l'écran des clés API de votre tableau de bord, à côté de la clé elle-même. Il s'agit du même identifiant pour chaque appel que vous effectuez.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.
curl -X GET https://api.zinndigital.com/v1/agency/time/report \
-H "Authorization: Bearer zdk_live_…"Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
⛔ **Unbilled, unpriced and non-billable are three different things and this says which.** Collapsing them is how an agency loses money quietly: hours with no rate card and hours marked internal both contribute nothing to revenue, but one is money about to be lost and the other is a decision they made. `billable_minutes` is the total minus non-billable — *not* "billed". An hour logged as billable and not yet invoiced is billable work, and calling it anything else is how an agency talks itself out of chasing it.
Paramètres
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
org_id (query) | string | Non | — |
from (query) | string | Non | Defaults to the first of the current month. |
to (query) | string | Non | Defaults to today. |
client_id (query) | string | Non | — |
user_id (query) | string | Non | — |
Réponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
period_start | string | Oui | — |
period_end | string | Oui | — |
total_minutes | integer | Oui | — |
billable_minutes | integer | Non | Total minus NON-BILLABLE — ⛔ not "billed". An hour logged as billable and not yet invoiced is billable work, and calling it anything else is how an agency talks itself out of ch… |
billed_minutes | integer | Oui | — |
unbilled_minutes | integer | Oui | — |
non_billable_minutes | integer | Oui | — |
billed_minor_by_currency | object | Non | — |
by_user | TimeReportBucket[] | Non | — |
by_client | TimeReportBucket[] | Non | — |
by_project | TimeReportBucket[] | Non | — |
Erreurs que cet point de terminaison peut renvoyer
401 · 403 · 422