Lisez le contrat avant de nous parler.

Le contrat parle pour lui-même

Tout ce qui concerne la requête et la réponse — chaque champ, son type, s’il est obligatoire, les structures imbriquées, des exemples complets, la politique d’obsolescence et la limite de débit — est servi par l’API elle-même :

curl https://cerrax-portal-api-zenqusyaia-nw.a.run.app/v1

C’est généré à partir des mêmes modèles qui valident votre requête : cela ne peut donc pas se désaligner de ce que le point d’accès accepte. C’est aussi pourquoi cette page est courte : tout ce que nous recopierions ici serait une deuxième copie, et les deuxièmes copies se périment.

Chiffrer un travail

La plus petite requête qui renvoie un prix :

curl -X POST https://cerrax-portal-api-zenqusyaia-nw.a.run.app/v1/price \
  -H "X-Cerrax-Api-Key: <votre clé>" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "ca",
    "volume": { "value": 1130, "unit": "ft3" },
    "distance": { "value": 77, "unit": "km" }
  }'

Fournissez distance (une valeur et une unité — ici, des kilomètres) ou les deux codes postaux. L’accès, les ajustements, le niveau d’emballage, les dates et votre propre référence sont tous facultatifs — et le guide des champs à /v1 les liste tous avec leur signification.

Ce que nous promettons, et ce que nous ne promettons pas

• Le même travail renvoie le même prix. Le moteur est déterministe et versionné ; une entrée et une version données produisent toujours le même chiffre, et chaque modification est publiée avec sa date à /kernel/changelog.
• Ajouter un champ n’est pas un changement cassant ; en retirer un donne une nouvelle version. La politique d’obsolescence complète, préavis compris, figure dans le contrat.
• La clé identifie l’entreprise. Il n’y a aucun champ moverId à transmettre — impossible de chiffrer au nom de quelqu’un d’autre par erreur.
• Un champ que nous n’acceptons pas est refusé, pas ignoré. Une faute de frappe renvoie une erreur 422 qui la nomme, plutôt qu’un prix qui a ignoré en silence ce que vous avez envoyé.
• Quand il ne sait pas, il le dit. Des entrées peu fiables peuvent revenir signalées pour un humain au lieu d’un chiffre. Nous préférons vous donner un refus honnête qu’une supposition assurée.

Obtenir une clé

Les clés sont délivrées par entreprise, au fil d’une conversation — nous débutons, et nous préférons comprendre ce que vous intégrez plutôt que distribuer des identifiants en masse. Dites-nous ce que vous construisez et nous répondrons sous un jour ouvrable.

Rien de ce qui précède n’en demande une. Si la lecture du contrat suffit à vous dire que ce n’est pas pour vous, c’est un bon résultat, et il ne vous a coûté qu’un curl.