agency-time
POST /v1/agency/time/projects
Create a time-tracking project.
Autentifikatsiya
API kalitini bearer token sifatida yuboring. Kalit agency.time.manage ruxsatiga ega boʻlishi shart; ruxsatsiz kalit 404 emas, balki 403 xatosi bilan rad etiladi.
Tashkilotingiz identifikatori kiritiladigan joy
Ushbu so'rov JSON tanasida org_id ni maydon sifatida qabul qiladi.
Tashkilotingiz identifikatori boshqaruv panelingizdagi API kalitlari ekranida, kalitning o'z yonida joylashgan. Bu siz amalga oshiradigan har bir so'rovda bir xil identifikator hisoblanadi.
Sinab ko'rish
Qavslardagi har qanday narsani o'z qiymatlaringiz bilan, kalit pleysxolderini эsa boshqaruv panelingizdagi kalit bilan almashtiring.
curl -X POST https://api.zinndigital.com/v1/agency/time/projects \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "name": <string> }'Tizimga kirganmisiz? Boshqaruv panelingizdagi API konsoli haqiqiy tashkilot ID raqamingiz va shaxsiy kalitingizni avtomatik to'ldiradi hamda haqiqiy javobni ko'rishingiz uchun so'rovni jonli API orqali bajaradi. Ushbu yakuniy nuqtani API konsolida oching
Tafsilotlar
Requires `agency.time.manage` and the `agency_project_board` entitlement. `currency` is set on the PROJECT rather than derived from whichever rate card wins, because an invoice has exactly one currency: a project whose rates disagreed would produce a document that cannot be issued. A rate card in another currency is refused rather than converted — FX is a driver decision, not a timesheet's.
Soʻrov tanasi
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
name | string | Ha | — |
client_id | string | Yo'q | — |
board_id | string | Yo'q | — |
currency | string | Yo'q | — |
org_id | string | Yo'q | — |
Javob
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
id | string | Ha | — |
name | string | Ha | — |
client_id | string | Ha | The agency's client this work is for, in the agency invoicing suite. `null` means **internal** work — reported on, never invoiced. |
board_id | string | Ha | The agency project board this work is run on, when there is one. |
currency | string | Ha | ISO currency this project's work is billed in. On the project because an invoice has exactly one currency; a rate card in another currency is refused rather than converted. |
archived | boolean | Ha | — |
created_at | string | Ha | — |
Ushbu yakuniy nuqta qaytarishi mumkin bo'lgan xatolar
401 · 403 · 422