compute

GET /v1/compute/eligibility

Whether this organisation may buy a machine on our own cloud.

Alle compute-eindpunten

Authenticatie

Stuur een API-sleutel mee als bearer token. De sleutel moet over de permissie sites.view beschikken; een sleutel zonder deze permissie wordt geweigerd met een 403 in plaats van een 404.

Waar je organisatie-id komt te staan

Dit eindpunt accepteert org_id als queryparameter. Laat deze achterwege en de aanroep destilleert je gehele tenant-substructie; stuur deze mee om de aanroep te beperken tot één organisatie.

Uw organisatie-id staat op het scherm met API-sleutels in uw dashboard, naast de sleutel zelf. Dit is in elke aanroep die u doet dezelfde id.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

curl -X GET https://api.zinndigital.com/v1/compute/eligibility \
  -H "Authorization: Bearer zdk_live_…"

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

Machines on **our own** infrastructure need a one-off verification before the first order. We are the account holder of record for that range, so a complaint about what a customer runs arrives at us — and there is no per-customer isolation at the provider, which means one abusive machine can suspend the whole account. ⛔ Four states, not a boolean. `not_requested` and `rejected` both refuse an order and the customer's next action is completely different: one is "tell us who you are" and the other is "we have decided, and here is why". Requires `sites.view`.

Parameters

NaamTypeVerplichtWat dit is
org_id (query)UuidNee

Reactie

NaamTypeVerplichtWat dit is
statestring<not_requested, pending, verified, rejected>Ja⛔ 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_orderbooleanJaTrue only in `verified`. Read this rather than re-deriving it from `state`.
legal_namestringJaThe legal name of whoever is responsible for the machines.
countrystringJaISO-3166-1 alpha-2 country of the person or the incorporation.
company_numberstringJaCompany registration number, or `""` for an individual — a real answer.
abuse_contact_emailstringJaA 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_usestringJaWhat the customer says the machines are for, in their own words.
rejection_reasonstringJaShown to the customer **verbatim** when `state` is `rejected`.
submitted_atstringJa
reviewed_atstringJa

Fouten die dit eindpunt kan retourneren

401 · 403 · 422 · 429