agency-time

POST `/v1/agency/time/rates`

Set a rate.

Doğrulama

API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.

Təşkilatınızın identifikatorunun yerləşdiyi yer

Bu son nöqtə JSON gövdəsində sahə kimi org_id qəbul edir.

Təşkilatınızın identifikatoru idarə panelinizdəki API açarları ekranında, açarın özünün yanında yerləşir. Bu, etdiyiniz hər bir sorğuda eyni identifikatordur.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

curl -X POST https://api.zinndigital.com/v1/agency/time/rates \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "scope": <string<task, project, client, org>>, "amount_minor": <integer>, "currency": <string>, "effective_from": <string> }'

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

amount_minor is the price of ONE HOUR for kind: hourly, and the price of the whole job for kind: fixed. ⛔ A fixed price is billed once for the task it is set on, however many hours are logged against it — the minutes are still recorded and reported, they simply do not each carry money. It is not "an hourly rate of zero".

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`scope`	`string<task, project, client, org>`	Bəli	—
`scope_id`	`string`	Xeyr	—
`kind`	`string<hourly, fixed>`	Xeyr	—
`amount_minor`	`integer`	Bəli	—
`currency`	`string`	Bəli	—
`effective_from`	`string`	Bəli	—
`org_id`	`string`	Xeyr	—

Cavab

Ad	Tip	Tələb olunur	Nədir
`id`	`string`	Bəli	—
`scope`	`string<task, project, client, org>`	Bəli	—
`scope_id`	`string`	Xeyr	The task/project/client this applies to. `null` exactly when scope is `org`.
`kind`	`string<hourly, fixed>`	Bəli	—
`amount_minor`	`integer`	Bəli	Minor units. For `hourly`, the price of ONE HOUR — ⛔ never a price per minute, and never divided by 60 anywhere on this API.
`currency`	`string`	Bəli	—
`effective_from`	`string`	Bəli	Applies to work done on or after this date. Resolution is against the work's date, never today, so a rate rise does not re-price last month.
`archived`	`boolean`	Bəli	—

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 422