Documents

    Clés API marchand et intégration des stocks (Pro+)

    Utilisez des clés côté serveur créées par le propriétaire pour trois routes API prises en charge, avec des budgets d'accès et d'utilisation du magasin limités.

    IntermédiaireGuide de configuration

    Créer une clé étendue

    En tant que propriétaire, ouvrez Gérer la boutique → Enterprise → Merchant API. Nommez la clé et choisissez uniquement les autorisations nécessaires : products:read, orders:read ou stock:write. Copiez le secret une seule fois dans un stockage sécurisé côté serveur ; il ne sera plus affiché.

    Lire le contrat API

    Le contrat OpenAPI public se trouve à /openapi/merchant-v1.json. Les routes prises en charge listent les produits, listent les commandes et modifient le stock hors clés. Utilisez une authentification Bearer, des pages limitées avec curseur et Idempotency-Key pour les modifications de stock. Il ne s'agit pas d'une API complète de paiement, de remboursement ou de création de comptes clients.

    Respecter les budgets et expiration

    Les clés créées par la console expirent après 90 jours. Les limites sont de 60 requêtes/minute par magasin et de 10 000/mois sur Pro ou 100 000 sur Enterprise ; les tentatives comptent. Gérez les réponses 401/403/409/429 et révoquez les clés inutilisées. Le transfert de propriétaire, la suspension ou la perte du forfait peuvent bloquer l’accès.

    Ce guide a-t-il été utile ?