Sandbox, production et le sélecteur d'environnement
Pourquoi une même page affiche des choses différentes selon un seul contrôle de la barre latérale
Votre organisation dispose de deux environnements, réellement séparés. Sandbox est l'endroit où vous et vos développeurs testez, avec des valeurs magiques qui produisent le résultat que vous demandez. Production correspond à de vraies personnes qui envoient de vrais documents.
Rien ne passe de l'un à l'autre. Une vérification sandbox n'est jamais facturée, n'atteint jamais le réseau antifraude et n'apparaît jamais dans une liste de production. Une clé créée pour l'un ne fonctionne pas dans l'autre.
Le sélecteur dans la barre latérale
Le contrôle d'environnement se trouve en bas de la barre latérale, et il a trois positions.
| Position | Ce que vous consultez |
|---|---|
| Sandbox | Le trafic de test uniquement |
| Production | Les vrais demandeurs uniquement |
| Tous les environnements | Les deux à la fois, avec un badge sur chaque ligne indiquant lequel est lequel |
Si vous pouvez ouvrir les deux, la console démarre dans Tous les environnements. C'est voulu. La vue d'un seul environnement ne peut pas vous dire qu'elle est incomplète, et une équipe dont l'intégration est répartie entre les deux peut perdre de vue la moitié de son trafic sans aucun signe pour l'alerter.
Créer quelque chose en consultant les deux
Lire les deux à la fois est simple. Créer quelque chose ne l'est pas, car un nouveau flux, une nouvelle clé API ou un nouveau point de terminaison webhook doit appartenir à l'un ou à l'autre environnement, et la vue combinée ne permet pas de le déduire.
La console vous pose donc la question. Créez un flux alors que vous êtes dans Tous les environnements, et la boîte de dialogue vous oblige à choisir où il sera construit. Le serveur refuse une écriture qui ne nomme aucun environnement plutôt que de deviner, et c'est pourquoi il est impossible de créer par erreur une clé de production en croyant faire un test.
Ce qui appartient à un environnement
Un flux appartient à un seul environnement pendant toute sa vie. Vous ne le déplacez pas, vous le promouvez, avec Copier vers live, qui crée une copie de production distincte et laisse le flux sandbox exactement tel qu'il était. Les modifications ultérieures de l'original sandbox ne suivent pas. La copie ne devient votre flux par défaut que lorsque vous la définissez comme tel.
Il en va de même pour les points de terminaison webhook : l'environnement est fixé à l'enregistrement du point de terminaison et ne peut plus être modifié ensuite. Les clés API le portent dans la clé elle-même. Les vérifications, les livraisons et l'utilisation portent chacune l'environnement du trafic qui les a produites.
Qui peut ouvrir quoi
L'accès à un environnement est une propriété de votre poste, définie par un propriétaire sur la page Équipe. Un membre peut avoir accès au sandbox seul, à la production seule, ou aux deux.
C'est la seule chose qui protège les données réelles des demandeurs. Il n'y a pas d'approbation séparée, pas de salle d'attente, et pas d'étape « demander la mise en production » : une organisation est en production dès sa création, et ce qui décide si un collègue donné voit de vraies personnes, c'est son poste.
Si le sélecteur refuse de passer en production, votre poste ne l'inclut pas, et un propriétaire peut vous l'accorder en quelques secondes.
Le sandbox est un lieu où l'on bascule, pas un point de départ
Ce n'est pas une période d'essai. Utilisez-le chaque fois que vous voulez répéter un changement : construisez le flux là-bas, faites-y passer des sessions de test, puis copiez-le vers la production lorsqu'il fait ce que vous voulez.
Les pages qui se comportent différemment en sandbox
Personnes est vide en sandbox. Les fiches des personnes sont construites à partir de l'activité réelle et le réseau antifraude ne couvre que le trafic de production, il n'y a donc rien à afficher tant que vous ne passez pas en production.
Utilisation compte le trafic sandbox mais ne le facture jamais, il se retrouve donc du côté non facturable de la répartition.
Analytique affichera volontiers le trafic de test, ce qu'il vaut mieux garder en tête avant de tirer la moindre conclusion d'un taux d'automatisation produit par des valeurs magiques.