Sandbox

Le Sandbox est l'environnement dans lequel vous intégrez l'API avant la Production. Il sert la même surface d'API que la Production, sur la même URL : c'est la clé qui décide de l'environnement. Les appels Sandbox passent par le même moteur de résolution ; ce qui change est la facturation, la dotation et les limites de débit.

Ce qui est identique à la Production

• Les trois routes, les mêmes champs, les mêmes en-têtes et les mêmes codes d'erreur.
• Le même moteur et la même politique de résolution : un libellé résolu en Sandbox l'est par le même calcul qu'en Production.
• Les mêmes règles d'idempotence, de déduplication, de validation et de rétention.

Ce qui diffère

La dotation de 2 000 unités

Le Sandbox porte une dotation à vie de 2 000 unités par organisation, pas par mois et pas par clé : toutes les clés Sandbox des workspaces d'une même organisation puisent dans la même dotation. Elle est posée à la création de l'organisation.

Un appel consomme les unités que son résultat porte, celles que la réponse annonce dans usage.units :

Une fois la dotation épuisée, un appel qui aurait consommé une unité est refusé :

{
  "type": "https://developer.noryo.app/errors/sandbox_quota_exhausted",
  "title": "Sandbox quota exhausted",
  "status": 402,
  "code": "sandbox_quota_exhausted",
  "detail": "The organization has used its Sandbox allowance. Move to Production to continue.",
  "request_id": "req_…"
}

Reprendre la même requête ne sert à rien : la dotation ne se recharge pas. Voir sandbox_quota_exhausted.

Deux mondes séparés

Sandbox et Production ne partagent rien : clés séparées, seaux de débit séparés, compteurs séparés. Un enrichment_id créé en Sandbox n'est pas lisible avec une clé de Production (et inversement) : la lecture rend 404. Les clés d'idempotence et les external_transaction_id sont, eux aussi, propres à chaque environnement. Un appel Sandbox ne peut jamais facturer un compte de Production. Voir Environnements.

Obtenir une clé Sandbox

Les clés Sandbox se créent dans la page Clés d'API de Platform. Tant que Noryo n'a pas ouvert l'émission de clés Sandbox, la création est refusée avec le message Sandbox access is not enabled yet.. Voir Clés API.