hosting
GET /v1/sites/provider-options
List the options available for a new site.
Authentification
Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.
Où insérer l'ID de votre organisation
Cet point de terminaison prend org_id comme paramètre de requête. Omettez-le et l'appel couvrira l'ensemble de votre sous-arbre de location ; envoyez-le pour restreindre l'appel à une seule organisation.
L'identifiant de votre organisation se trouve sur l'écran des clés API de votre tableau de bord, à côté de la clé elle-même. Il s'agit du même identifiant pour chaque appel que vous effectuez.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.
curl -X GET https://api.zinndigital.com/v1/sites/provider-options \
-H "Authorization: Bearer zdk_live_…"Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
What a customer may choose on `POST /v1/sites`: `cdn_vendor` / `dns_vendor`, `stack_type` and `source`. The vendors are answered from the provider-account pool serving this organization — its own (BYO) accounts when it has any, otherwise the platform pool — so the picker can never offer a vendor the site would then fail to provision on. On a managed line the CDN answer is `managed: true` with an empty vendor list: the platform spreads Footprint-Free sites across the pool deliberately and does not disclose which vendor fronts a site. `stacks` and `sources` answer the same question for the other two pickers — only what this deployment can actually build. Note there is deliberately **no** `runtime`: it is derived from the stack, not chosen.
Paramètres
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
org_id (query) | Uuid | Non | The organization to answer for. Defaults to the caller's first org in scope; an org outside scope is a `404` rather than a `403`, so this cannot be used to probe which organizat… |
product_line (query) | string | Non | The product line the site will be created on. Decides whether the CDN choice is platform-managed; omit for the unmanaged answer. |
cdn_vendor (query) | string | Non | The CDN the customer has chosen, which **narrows the DNS answer**. Choosing Cloudflare restricts DNS to Cloudflare: its edge proxies a record in place inside its own authoritati… |
Réponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
product_line | string | Oui | The product line the answer was computed for (echoed from the query). |
cdn | SiteCdnChoice | Oui | — |
dns | SiteDnsChoice | Oui | — |
stacks | StackType[] | Oui | The `stack_type` values that can actually be provisioned — those with a published blueprint. Every other `StackType` member is a `422` on create. |
sources | SiteSource[] | Oui | The `source` values a site can actually be built from. `migrate` and `wayback` appear only where the import workflows are deployed; elsewhere offering them would create a site w… |
deploy_targets | SiteDeployTargetOffer[] | Oui | The edge hosts this organization can point a new site at — its own connected provider accounts, sold through the extra-externally-hosted-sites add-on. **Every** edge host appear… |
Erreurs que cet point de terminaison peut renvoyer
401 · 403 · 404