ప్రమాణీకరణ
బీయర్ టోకెన్గా API కీని పంపండి. కీ తప్పనిసరిగా agency.time.log అనుమతిని కలిగి ఉండాలి; అది లేని కీని 404 కాకుండా 403తో తిరస్కరిస్తారు.
ఈ ఎండ్పాయింట్ ఎలాంటి సంస్థ ఐడీని తీసుకోదు. మీ కీ ఇప్పటికే అది ఏ సంస్థకు చెందుతుందో గుర్తిస్తుంది మరియు ప్రతిస్పందన దానికే పరిమితం చేయబడుతుంది.
ప్రయత్నించండి
కోణీయ బ్రాకెట్లలో ఉన్న దేన్నైనా మీ స్వంత విలువలతో భర్తీ చేయండి, మరియు కీ ప్లేస్హోల్డర్ను మీ డాష్బోర్డ్ నుండి తీసుకున్న కీతో భర్తీ చేయండి.
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> }'సైన్ ఇన్ చేశారా? మీ డ్యాష్బోర్డ్లోని API కాన్సోల్ మీ అసలైన సంస్థ ID మరియు మీ స్వంత కీని నింపుతుంది, అలాగే మీరు అసలైన ప్రతిస్పందనను చూడటానికి లైవ్ API ద్వారా ఆభ్యర్థనను రన్ చేస్తుంది. ఈ ఎండ్పాయింట్ను API కన్సోల్లో తెరిచండి
వివరాలు
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.
అభ్యర్థన బాడీ
| పేరు | రకం | కావలసినది | ఇది ఏమిటి |
|---|---|---|---|
project_id | string | అవును | — |
task_id | string | కాదు | — |
work_date | string | అవును | — |
minutes | integer | అవును | — |
description | string | కాదు | — |
billable | boolean | కాదు | — |
user_id | string | కాదు | Log on somebody else's behalf. Requires agency.time.manage; without it a caller may only log their own time. |
స్పందన
| పేరు | రకం | కావలసినది | ఇది ఏమిటి |
|---|---|---|---|
id | string | అవును | — |
user_id | string | కాదు | — |
project_id | string | అవును | — |
project_name | string | కాదు | — |
task_id | string | కాదు | — |
task_name | string | కాదు | — |
client_id | string | కాదు | — |
work_date | string | అవును | — |
minutes | integer | అవును | ⛔ 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 | అవును | Presentational only — never multiplied by anything. |
description | string | కాదు | — |
billable | boolean | అవును | — |
billing_run_id | string | కాదు | The run that invoiced this entry. null means it is still outstanding. |
billed_rate_minor_per_hour | integer | కాదు | — |
billed_amount_minor | integer | కాదు | 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 | కాదు | — |
billed_under_fixed_price | boolean | కాదు | 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 | కాదు | 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> | కాదు | Which rate card won, so a surprising invoice can be explained. |
rate_kind | string<hourly, fixed> | కాదు | — |
created_at | string | అవును | — |
ఈ ఎండ్పాయింట్ తిరిగి ఇవ్వగల లోపాలు
401 · 403 · 422