Documentation technique pour les développeurs. Connectez BaseLinker, WooCommerce, Apilo ou votre propre solution WMS/ERP directement à Scopio Marketplace. Assurez la récupération automatique des commandes et la synchronisation des statuts de livraison.
Clés API Vendeur
Chaque requête à l'API Scopio doit être autorisée par un token de vendeur unique. Ce token est généré dans l'interface d'administration. Utilisez l'en-tête Authorization avec le préfixe Bearer, ou directement l'en-tête X-API-Key.
Les tokens disposent de permissions liées à votre compte vendeur. Conservez-les de manière sécurisée (par exemple dans des variables d'environnement) et ne les exposez jamais dans le code client. L'API nécessite obligatoirement des connexions chiffrées en TLS 1.3.
# Authorization Header
Authorization: Bearer sk_mkt_ca1d5b9...
X-API-Key: sk_mkt_ca1d5b9...
Point de terminaison : GET /api/seller/orders
Ce point de terminaison permet de récupérer automatiquement les commandes payées. Il renvoie uniquement les articles de commande appartenant à votre offre vendeur (filtrage par sellerId). Les adresses de livraison et modes d'expédition sont transmis en JSON.
L'intervalle d'interrogation (polling) recommandé est de 5 à 15 minutes. La réponse contient le champ shipping_address avec les coordonnées complètes de l'acheteur, la liste des produits avec codes EAN, quantités et tarifs.
# Response excerpt
{ "success": true, "orders": [...] }
Point de terminaison : POST /api/seller/orders/{orderId}/fulfill
Une fois le colis préparé et l'étiquette d'expédition générée dans votre ERP, renvoyez le statut de traitement à Scopio. Indiquez le numéro de suivi et le code du transporteur pour mettre à jour la commande instantanément.
Codes de transporteurs acceptés : inpost_locker (points relais), inpost_courier, dpd, dhl, ups. Vous pouvez également transmettre un lien de téléchargement PDF de l'étiquette (label_url) pour affichage dans Scopio.
# Payload data
{ "tracking_number": "XYZ123", "carrier": "inpost_locker" }
Événements HTTP POST instantanés
Configurez une URL de Webhook dans votre compte vendeur pour recevoir des événements en temps réel. Le système envoie immédiatement une requête POST à votre adresse dès la validation de paiement, supprimant le besoin de polling continu.
Chaque payload de webhook contient un en-tête de signature généré par un Webhook Secret pour vérifier la provenance de la requête. En cas d'échec de transmission, l'envoi sera tenté à nouveau 3 fois.
Prêt pour l'économie des agents IA
Toutes les structures et statuts des commandes sont entièrement compatibles avec le protocole Universal Commerce Protocol (UCP). Cela permet aux bots de recherche et d'achat autonomes d'interpréter facilement les données.
Grâce au format UCP, les transactions initiées par des assistants d'achat automatisés sont intégrées à votre CRM sans avoir à développer un parser personnalisé pour chaque robot.
Sécurité et stabilité des infrastructures
La limite de requêtes par défaut est fixée à 120 appels par minute par clé API ou adresse IP. Tout dépassement retourne une erreur HTTP 429. Les erreurs sont renvoyées sous forme d'objets JSON avec code d'erreur.
Codes HTTP retournés : 400 (payload incorrect), 401 (non autorisé), 403 (accès refusé), 404 (commande introuvable), 500 (erreur interne du serveur). Toutes les erreurs sont consignées dans les logs.
# HTTP 429 Rate Limit Response
{ "error": "Too Many Requests", "retry_after_seconds": 60 }
