Traduite de l'anglais. En cas de différence, la page en anglais fait foi. Lire en anglais
Tester votre intégration
Deux façons de tester sans affecter personne : des clés de test pour vérifier chaque requête, et une sandbox pour exécuter toute votre intégration pour de vrai sans être facturé.
Il existe deux façons de tester, qui répondent à des questions différentes :
- Les clés de test répondent à « cette requête est-elle correcte ? » Chaque appel est vérifié et simulé, rien n'est enregistré.
- La sandbox (pour les partenaires) répond à « toute mon intégration fonctionne-t-elle ? » Tout se passe pour de vrai, avec de vraies entreprises, de vrais canaux, webhooks et commandes, mais rien n'est facturé.
La plupart des intégrations utilisent les deux : les clés de test pendant l'écriture de chaque appel, la sandbox pour exécuter le parcours complet de bout en bout avant la mise en production.
En un coup d'œil
Clé de test (nbl_test_…) | Partenaire en sandbox (clé live) | |
|---|---|---|
| Pour qui | Tout le monde | Partenaires (accounts:manage) |
| Les requêtes sont validées | Oui, exactement comme en live | Oui, c'est du live |
| Les données sont enregistrées | Non. Un produit que vous « créez » ne peut pas être relu | Oui |
| Canaux (Shopify, eBay…) | Jamais touchés ; résultats marqués "simulated" | Réellement mis à jour. Connectez des boutiques de test |
| Webhooks et événements | Aucun | Oui, comme en live (account_id sur chaque événement d'entreprise) |
Entreprises (POST /accounts) | Simulées (acct_test, "simulated": true). Vous ne pouvez pas travailler à l'intérieur | Réelles, 3 ouvertes au maximum en même temps |
| Facturation | Jamais | Jamais. Le relevé affiche 0 et sandbox: true |
| Mise en production | Passez à votre clé nbl_live_ | Passer en production dans le tableau de bord ; même clé, mêmes entreprises |
Clés de test
Créez-en une dans Paramètres → Développeurs (mode Test). Utilisez-la exactement comme une clé live :
curl -X POST https://api.nembol.com/rest/v1/products \
-H "Authorization: Bearer nbl_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"title": "Test mug", "variants": [{"sku": "MUG-1", "price": "12.00", "quantity": 5}]}'La réponse a la forme qu'aurait un appel live, avec "simulated": true.
Les erreurs sont réelles : un champ manquant, un format de prix incorrect ou une
autorisation manquante répondent exactement comme en live.
Ce qu'une clé de test ne fait pas :
- Rien n'est enregistré. Les appels de lecture renvoient les vraies données de votre boutique : un
produit simulé n'apparaît donc jamais dans
GET /products. Testez chaque écriture isolément ; n'enchaînez pas « créer, puis relire ». - Aucun canal n'est contacté, aucune commande n'est expédiée, aucun e-mail n'est envoyé.
- Aucun événement ni webhook n'est produit par les appels simulés.
Sandbox (partenaires)
La sandbox est votre compte partenaire avec la facturation désactivée. Tout fonctionne comme en live (c'est tout l'intérêt) : vous pouvez donc construire toute l'intégration et la regarder tourner :
- Votre compte partenaire démarre en sandbox : Nembol l'active ainsi.
Vérifiez-le avec
GET /partner/billing, qui répond"sandbox": trueet"sandbox_max_accounts": 3. - Créez jusqu'à 3 entreprises avec
POST /accounts. Une 4e entreprise ouverte répond409 sandbox_limit. Fermez-en une (POST /accounts/{id}/close) pour libérer une place. - Connectez des boutiques de test, pas de vraies boutiques : une boutique de développement Shopify, un compte de test eBay ou Etsy, un site WooCommerce qui vous appartient. Les annonces, le stock et les commandes les atteignent réellement. Les marketplaces avec des acheteurs (Amazon, TikTok Shop) sont de vraies marketplaces : publiez avec prudence et retirez vos annonces une fois terminé.
- Recevez les webhooks et interrogez l'API exactement comme en production : les événements de chaque entreprise
arrivent sur vos endpoints avec
account_id. - Vérifiez le relevé :
GET /partner/statementliste vos entreprises avec un montant de 0 et"sandbox": true.
Passer en production
Quand votre intégration est prête, passez vous-même en production depuis le tableau de bord : Paramètres → Partenaire → Passer en production (sur l'avis Sandbox).
- Si vous payez par carte, ajoutez d'abord une carte. Nembol ouvre une page Stripe sécurisée qui enregistre la carte sans rien débiter.
- Confirmez. La fenêtre indique combien d'entreprises sont ouvertes et ce qu'elles coûtent par mois à vos tarifs. La facturation commence le jour même, au prorata des jours.
GET /partner/billingrépond alors"sandbox": false.
Votre clé, vos entreprises, leurs canaux et vos webhooks restent exactement tels quels, sans rien à migrer. Fermez les entreprises de test que vous ne voulez pas voir facturées avant de passer en production.
Le passage en production est sans retour : revenir en arrière arrêterait la facturation des entreprises live. Pour revenir à la sandbox, écrivez à developer@nembol.com. Ce n'est volontairement pas disponible depuis l'API : la facturation ne démarre ainsi jamais par erreur depuis un script.
Lequel utiliser, et quand
- Écrire un nouvel appel ou une nouvelle branche de gestion d'erreur → clé de test.
- Vérifier qu'un gestionnaire de webhook, le flux de connexion (lien de retour), l'interrogation des commandes et leur traitement fonctionnent ensemble → sandbox.
- Une intégration vendeur uniquement (sans programme partenaire) → clé de test, puis une clé live sur une boutique de test connectée à votre propre boutique Nembol.
Dernière mise à jour le 20 octobre 2026
Besoin d'aide ?
Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.