catalog

GET /v1/catalog/compute

List the sellable cloud machine sizes.

Tous les points de terminaison catalog

Authentification

Cet point de terminaison est public. Il ne nécessite aucun identifiant ni aucune organisation : c'est ce que notre propre site marketing et nos moteurs de réponse IA lisent.

Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.

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/catalog/compute

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

Every Zinn® Cloud size a customer may buy, with **every cadence it is priced at**, read straight from the catalogue rows an operator edits in admin. **Public** — no authentication, no tenant, no principal — and cacheable exactly like `listCatalogPlans` (strong `ETag` + `max-age=60`). **This is not `getComputeCatalogue` made public, and it deliberately cannot become it.** That endpoint (`GET /v1/compute/catalogue`, `sites.view`) reads the provider matrix, which is an org-scoped live call to the vendor with the org's own credentials. This one is a pure read of our own plan and price rows, which is why it can be served to a logged-out visitor at all. The corollary is part of the contract: **this endpoint returns no providers and no data centres.** Both are defaulted server-side at checkout, once an org exists to read them with. Only sizes that can actually be **bought** are listed. A size with no vendor spec token, or with no price at any sellable cadence, is one the cart refuses — listing it would be a configurator that offers a size and then answers `422`. Returned **whole, not cursor-paginated**, matching `listCatalogPlans`: a configurator needs every size at once to render a comparison, not 50 at a time.

Paramètres

NomTypeObligatoireQu'est-ce que c'est
If-None-Match (header)stringNonA previously returned `ETag`; a match responds `304`.

Réponse

NomTypeObligatoireQu'est-ce que c'est
dataPublicComputeTier[]Oui

Erreurs que cet point de terminaison peut renvoyer

429