Aperçu : Capydra ouvre bientôt. Il n'est pas encore possible de commander.

Capydra
Plus Aide Panier
Offre de la semaine

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.

Bientôt disponibleVers 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.

Prête, ouverture avec le lancement des ventes

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 ventes
  • Dé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 ventes
  • Ré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 ventes
  • Recevoir 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 ventes
  • Proposer 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 ventes
  • Utiliser 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. 1

    Créer un compte

    Vous vous connectez à la boutique.

  2. 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. 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. 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. 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. 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

403

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