agency-time

POST `/v1/agency/time/projects`

Create a time-tracking project.

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα agency.time.manage· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.

Πού μπαίνει το αναγνωριστικό του οργανισμού σας

Αυτό το endpoint δέχεται το πεδίο org_id στο σώμα JSON.

Το αναγνωριστικό του οργανισμού σας βρίσκεται στην οθόνη των κλειδιών API στον πίνακα ελέγχου σας, δίπλα στο ίδιο το κλειδί. Είναι το ίδιο αναγνωριστικό σε κάθε κλήση που πραγματοποιείτε.

Δοκιμάστε το

Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.

curl -X POST https://api.zinndigital.com/v1/agency/time/projects \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <string> }'

Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API

Λεπτομέρειες

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.

Σώμα αίτησης

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`name`	`string`	Ναι	—
`client_id`	`string`	Όχι	—
`board_id`	`string`	Όχι	—
`currency`	`string`	Όχι	—
`org_id`	`string`	Όχι	—

Απάντηση

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`id`	`string`	Ναι	—
`name`	`string`	Ναι	—
`client_id`	`string`	Ναι	The agency's client this work is for, in the agency invoicing suite. `null` means internal work — reported on, never invoiced.
`board_id`	`string`	Ναι	The agency project board this work is run on, when there is one.
`source_quote_id`	`string`	Όχι	The free-quote request this project was started from (docs/670 §2), or `null` for a project made by hand. At most one project per quote.
`currency`	`string`	Ναι	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`	Ναι	—
`created_at`	`string`	Ναι	—

Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο

401 · 403 · 422

POST /v1/agency/time/projects