agency-time

POST `/v1/agency/time/projects/from-quote`

Start a project from a free-quote request.

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar agency.time.manage iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Kurum kimliğinizin yazılacağı yer

Bu uç nokta, JSON gövdesinde bir alan olarak org_id alır.

Kuruluş kimliğiniz (id), kontrol panelinizdeki API anahtarları ekranında, anahtarın hemen yanında yer alır. Yaptığınız her çağrıda aynı kimlik kullanılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

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

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

Zinn Digital®'s own organisation only (docs/670 §2). In one transaction: the requester becomes a client (found by e-mail, or created, carrying the request's country), a project board is opened with the brief, a time project is linked to both in the quoted currency, the quoted price becomes a fixed-price task, and the request is marked won — which is what stops the admin queue's charge conversion and the draft-from-quote invoice billing the same job again. Requires agency.time.manage in the organisation and the quotes.manage staff permission the admin queue requires. Idempotent per request: a second call returns the project the first one made, with created: false.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`quote_id`	`string`	Evet	—
`amount_minor`	`integer`	Hayır	The agreed price, NET, in minor units — only for a request that has not been priced. On a priced request omit it; a different figure is refused.
`currency`	`string`	Hayır	—
`country`	`string`	Hayır	The client's ISO-2 country, used only when the request carries none (the public form does not ask). The bill on the checkout needs it; anything but two letters is refused.
`org_id`	`string`	Hayır	—

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`project`	`TimeProject`	Evet	—
`board_id`	`string`	Evet	—
`client_id`	`string`	Evet	—
`created`	`boolean`	Evet	FALSE when a project for this request already existed and was returned.
`price_already_billed_on`	`string`	Hayır	The reference of a bill already drafted straight from this request, when there was one — in which case the project carries no fixed price, because that bill charges it.

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 422