compute

POST `/v1/compute/eligibility`

Submit an organisation for verification.

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Ufunguo lazima uwe na ruhusa ya billing.payment.manage; ufunguo usio nayo unakataliwa kwa 403, si 404.

Mahali ambapo kitambulisho cha shirika lako huwekwa

Kigezo hiki kinachukua org_id kama kigezo cha utafutaji. Iache wazi na simu itashughulikia tawi lako lote la wapangaji; itume ili kupunguza simu iwe ya shirika moja tu.

Kitambulisho cha shirika lako kipo kwenye skrini ya funguo za API katika dashibodi yako, kando ya ufunguo wenyewe. Ni kitambulisho kile kile katika kila ombi unalofanya.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

curl -X POST https://api.zinndigital.com/v1/compute/eligibility \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "legal_name": <string>, "country": <string>, "abuse_contact_email": <string> }'

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

Moves the organisation to `pending` for a human to review. **202**, because the answer is a decision somebody makes rather than something this call performs. ⛔ An organisation that is already verified, or already pending, is refused `422` rather than silently re-queued: resubmitting would otherwise let a customer suspend their own verification, and let a rejected applicant re-enter the queue for ever. Requires `billing.payment.manage` — ⛔ **not** `billing.entitlement.manage`, a staff key no customer role holds, which is what this said until D10689.

Vigezo

Jina	Aina	Inayohitajika	Kilicho hiki
`org_id (query)`	`Uuid`	Hapana	—

Mwili wa ombi

Jina	Aina	Inayohitajika	Kilicho hiki
`legal_name`	`string`	Ndiyo	—
`country`	`string`	Ndiyo	—
`abuse_contact_email`	`string`	Ndiyo	—
`company_number`	`string`	Hapana	—
`intended_use`	`string`	Hapana	—

Majibu

Jina	Aina	Inayohitajika	Kilicho hiki
`state`	`string<not_requested, pending, verified, rejected>`	Ndiyo	⛔ Four states, not a boolean. `not_requested` and `rejected` both refuse an order and the customer's next action differs completely: one is "tell us who you are", the other is "…
`may_order`	`boolean`	Ndiyo	True only in `verified`. Read this rather than re-deriving it from `state`.
`legal_name`	`string`	Ndiyo	The legal name of whoever is responsible for the machines.
`country`	`string`	Ndiyo	ISO-3166-1 alpha-2 country of the person or the incorporation.
`company_number`	`string`	Ndiyo	Company registration number, or `""` for an individual — a real answer.
`abuse_contact_email`	`string`	Ndiyo	A monitored address an abuse report can be forwarded to and answered from. We are the account holder of record, so a complaint reaches us first and has to reach the customer wit…
`intended_use`	`string`	Ndiyo	What the customer says the machines are for, in their own words.
`rejection_reason`	`string`	Ndiyo	Shown to the customer verbatim when `state` is `rejected`.
`submitted_at`	`string`	Ndiyo	—
`reviewed_at`	`string`	Ndiyo	—

Hitilafu ambazo mwisho huu unaweza kurudisha

401 · 403 · 422 · 429