Traduite de l'anglais. En cas de différence, la page en anglais fait foi. Lire en anglais
Authentification
Clés API, scopes, mode test et règles de sécurité qui protègent votre boutique.
Toutes les requêtes sont authentifiées avec une clé API propre à la boutique, envoyée comme jeton Bearer :
curl https://api.nembol.com/rest/v1/store \
-H "Authorization: Bearer nbl_live_xxxxxxxxxxxxxxxxxxxxxxxx"Les clés sont créées par le propriétaire de la boutique dans le tableau de bord Nembol, sous Paramètres → Développeurs. Le secret complet n'est affiché qu'une seule fois, à la création. Conservez-le dans un gestionnaire de secrets. Ensuite, seuls le nom et le préfixe restent visibles.
Modes de clé
| Préfixe | Mode | Comportement |
|---|---|---|
nbl_live_ | Live | Accès complet ; les écritures sont propagées à vos canaux. |
nbl_test_ | Test | Tout est validé et simulé ; rien n'est enregistré et aucun canal n'est jamais touché. Les résultats simulés des canaux sont marqués "simulated". |
Commencez l'intégration avec une clé de test ; passez à une clé live quand vos flux fonctionnent. Les partenaires peuvent aussi exécuter toute l'intégration pour de vrai, sans facturation, dans la sandbox.
Utilisez votre clé dans les exemples
Collez une clé de test (nbl_test_…) et chaque bloc de code de ce site l'insère pour vous. Elle reste uniquement dans ce navigateur et n'est jamais envoyée.
Scopes
Chaque clé ne possède que les scopes que vous lui accordez :
| Scope | Autorise |
|---|---|
products:read | Lire les produits, les variantes, les annonces |
products:write | Créer, modifier, supprimer des produits et des images |
inventory:write | Modifier uniquement la quantité et le prix (plus sûr pour les intégrations de synchronisation de stock) |
listings:write | Publier et retirer par canal |
orders:read | Lire les commandes. Inclut les données personnelles des acheteurs : traitez-les dans le respect de la loi |
orders:write | Marquer les commandes comme expédiées, joindre le suivi, notifier la marketplace |
webhooks:manage | Gérer les endpoints de webhook |
events:read | Lire le journal des événements |
channels:write | Modifier les paramètres des comptes de canal : règles de synchronisation, règle de prix, plafond de quantité, politiques et collection par défaut |
channels:connect | Connecter et déconnecter des comptes de canal, gérer les URL de redirection utilisées par les liens de connexion |
billing:read | Lire le plan de la boutique, son utilisation, son moyen de paiement et ses factures |
storefront:write | Paramètres du Storefront (hors paiements), codes de réduction et lots |
promotions:write | Créer, modifier, arrêter et supprimer des promotions (soldes temporaires sur les canaux) |
billing:manage | Créer des liens pour s'abonner, changer de plan, mettre à jour la carte, résilier ou renouveler ; relancer l'essai gratuit |
accounts:manage | Partenaires uniquement. Créer, modifier et fermer vos entreprises, lire le relevé et la facturation partenaire, et travailler à l'intérieur d'une entreprise avec l'en-tête Nembol-Account (sans cette autorisation, toute requête avec cet en-tête répond 403 insufficient_scope). Il n'apparaît dans Paramètres → Développeurs que sur un compte partenaire, et le préréglage Lecture et écriture l'inclut. Voir Programme partenaire. |
Les requêtes sans le scope nécessaire échouent avec 403 et
error.type: "authentication_error".
Règles de sécurité
- N'utilisez jamais de clés API dans du code navigateur ou mobile. L'API fonctionne de serveur à serveur ; les navigateurs sont bloqués par CORS à dessein (la seule origine autorisée est le playground de cette documentation).
- Une clé par intégration. Ne partagez pas une clé entre plusieurs systèmes : vous pourrez ainsi en renouveler une sans casser les autres.
- Renouvelez immédiatement une clé divulguée (tableau de bord → clé → Renouveler) : l'ancien secret cesse aussitôt de fonctionner, et vous recevez un nouveau secret, affiché une seule fois.
- Les clés peuvent être révoquées à tout moment ; la révocation est immédiate.
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é.