API
Catalogue, commandes et clés via une interface
Intégrez notre catalogue dans votre système, déclenchez des commandes et récupérez les clés. Cette page montre la marche à suivre en six étapes. Les limites, l'environnement de test et les restrictions figurent dans la documentation.
Cela fonctionnera dès l'ouverture de la boutique. D'ici là, vous pouvez tout lire tranquillement.
Page développeurs
OpenAPI
Chaque appel est décrit dans un fichier OpenAPI 3.1. Chaque chiffre des pages est celui que le code applique.
- BearerUne clé par application, stockée uniquement sous forme de hash, avec expiration et rotation
- JSONMontants en centimes entiers, dates au format ISO 8601, noms en snake_case
- 120 par minutelectures pour une nouvelle clé, 600 dès qu'elle a 7 jours
- SignéWebhooks avec signature, et sur demande aussi des appels signés (RFC 9421)
L'API est développée et testée, la documentation est en ligne. Les clés pourront être créées dès l'ouverture de la boutique. Pas encore disponibles et seulement prévus : un kit logiciel prêt à l'emploi, un crédit prépayé.
Ce que vous pouvez en faire
Synchroniser le catalogue
Chargez la liste complète une fois, puis uniquement ce qui a changé depuis votre dernière synchronisation. Une vue légère n'affiche que le stock.
Prête, ouverture avec le lancement des ventesDéclencher des commandes
Une commande par appel, avec plafond de prix, votre propre numéro et une clé contre les achats en double.
Prête, ouverture avec le lancement des ventesRécupérer les clés
Avec un droit dédié, compté et consigné. Le premier appel met fin au droit de rétractation de cette commande.
Prête, ouverture avec le lancement des ventesRecevoir des webhooks
Des appels signés vers votre serveur lorsqu'une commande ou un produit change. Jusqu'à 3 adresses.
Prête, ouverture avec le lancement des ventesProposer en tant que vendeur
Gérez offres, prix et stock depuis votre système de stock. Cela suppose que la vente sur Capydra soit ouverte.
Prête, ouverture avec le lancement des ventesUtiliser avec des assistants IA
Le même compte fonctionne via notre serveur MCP. Les règles et les limites sont les mêmes.
Prête, ouverture avec le lancement des ventes
Six étapes jusqu'au premier appel
- 1
Créer un compte
Vous vous connectez à la boutique.
- 2
Créer une clé d'accès
Sous « Clés API » : un nom, le rôle (acheteur ou vendeur) et les droits dont vous avez besoin. Accordez-en le moins possible.
- 3
Confirmer la renonciation
Deux phrases sur la rétractation, une seule fois. Chaque commande passée avec la clé s'y réfère.
- 4
Sécuriser la clé
Elle n'est affichée qu'une seule fois. Conservez-la comme un mot de passe et ajoutez à la liste les adresses IP de vos serveurs.
- 5
Définir une limite journalière
Le total de toutes les commandes d'une journée est plafonné : €250 pour une nouvelle clé, réglable jusqu'à €5,000.
- 6
Envoyer le premier appel
Avec la clé dans l'en-tête « Authorization ». L'exemple ci-dessous lit les premiers produits.
Le premier appel
Une clé commence par omk_live_. Elle est transmise à chaque appel comme valeur Bearer. Les montants sont exprimés en centimes entiers et incluent les frais de service.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# uniquement ce qui a changé depuis votre dernière synchronisation
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Suite dans la documentation
La boutique n'est pas encore ouverte : les appels qui modifient quelque chose répondent 403 showcase_mode, et les réponses ne contiennent aucun prix.
Questions fréquentes
Combien coûte l'API ?
L'accès est gratuit. Vous payez les commandes que vous déclenchez. Il n'y a pas de frais fixes.
Existe-t-il un kit logiciel ?
Pas encore. La documentation contient des exemples avec curl, et le fichier OpenAPI se charge dans les outils courants.
Comment obtenir des limites plus élevées ?
Écrivez-nous votre projet et votre volume. Nous relevons les limites pour les partenaires dont nous voyons le besoin.
Que se passe-t-il si ma clé est volée ?
Révoquez-la sur la page des clés et créez-en une nouvelle. D'ici là, la limite journalière et la liste d'IP limitent les dégâts. Des appels suspects bloquent la clé automatiquement.
Où signaler une erreur de l'API ?
Via le formulaire de contact avec le sujet API. Indiquez l'appel et l'heure.
Prêt pour le premier appel ?
Lisez la page développeurs en entier, puis créez une clé d'accès.
Envoyer une demande