Uwierzytelnianie
Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie agency.time.log; klucz bez niego jest odrzucany z kodem 403, a nie 404.
Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.
Wypróbuj
Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.
curl -X POST https://api.zinndigital.com/v1/agency/time/entries \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "project_id": <string>, "work_date": <string>, "minutes": <integer> }'Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API
Szczegóły
minutes is an integer, 1..1440. Requires agency.time.log for your own time, or agency.time.manage to pass user_id and log on somebody else's behalf. If this client's billing schedule is "invoice straight away", logging arms it and starts the billing workflow immediately — the invoice is raised in seconds rather than at the next sweep, without the invoicing call ever sitting in this request.
Treść żądania
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
project_id | string | Tak | — |
task_id | string | Nie | — |
work_date | string | Tak | — |
minutes | integer | Tak | — |
description | string | Nie | — |
billable | boolean | Nie | — |
user_id | string | Nie | Log on somebody else's behalf. Requires agency.time.manage; without it a caller may only log their own time. |
Odpowiedź
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
id | string | Tak | — |
user_id | string | Nie | — |
project_id | string | Tak | — |
project_name | string | Nie | — |
task_id | string | Nie | — |
task_name | string | Nie | — |
client_id | string | Nie | — |
work_date | string | Tak | — |
minutes | integer | Tak | ⛔ An INTEGER of minutes. There is no hours field on this API: an hours-as-float duration re-enters the money through the rate and no rounding point can recover it. |
duration_label | string | Tak | Presentational only — never multiplied by anything. |
description | string | Nie | — |
billable | boolean | Tak | — |
billing_run_id | string | Nie | The run that invoiced this entry. null means it is still outstanding. |
billed_rate_minor_per_hour | integer | Nie | — |
billed_amount_minor | integer | Nie | What was actually charged, frozen at billing time so the document can be re-derived years later even if every rate card has since changed. |
billed_currency | string | Nie | — |
billed_under_fixed_price | boolean | Nie | TRUE when these minutes were rolled into a task's FIXED price rather than charged by the hour. billed_amount_minor is then 0 and that zero is correct — read this flag, not the… |
rate_minor_per_hour | integer | Nie | The rate that WOULD apply, resolved against this entry's own work_date, for an entry not yet billed. ⛔ null means unpriced, not free: work with no rate card is never… |
rate_scope | string<task, project, client, org> | Nie | Which rate card won, so a surprising invoice can be explained. |
rate_kind | string<hourly, fixed> | Nie | — |
created_at | string | Tak | — |
Błędy, które ten punkt końcowy może zwrócić
401 · 403 · 422