Développeurs

L'API publique de ControlResell

Automatisez votre activité depuis vos propres scripts et outils : lisez vos comptes, vos articles et vos conversations avec une clé d'API.

L'API publique est en cours de déploiement. Elle est réservée aux abonnements qui l'incluent et ouverte progressivement : la page de gestion des clés n'est pas encore visible sur tous les comptes. Sans accès, l'API répond par une erreur 402.

Générer votre clé d'API

Les clés se créent dans l'application, avec votre session. Une clé ne peut pas en créer, lister ou révoquer une autre.

  1. Connectez-vous à l'application ControlResell sur le web.
  2. Ouvrez Paramètres, puis Développeurs.
  3. Créez une clé : donnez-lui un nom, cochez au moins une portée et, si vous le souhaitez, une date d'expiration (5 ans au plus).
  4. Copiez le secret tout de suite : il n'est affiché qu'une seule fois.

Gérer mes clés d'API

Le secret commence par cr_live_. Gardez-le comme un mot de passe : ControlResell n'en conserve qu'une empreinte et ne peut pas vous le montrer à nouveau. En cas de doute, révoquez la clé et créez-en une autre.

Envoyez la clé dans l'en-tête Authorization de chaque appel. Exemple pour lire votre profil :

curl https://api.controlresell.com/api/public/v1/me \
  -H "Authorization: Bearer cr_live_..."

Vous pouvez avoir 10 clés actives au plus, chacune révocable à tout moment.

Portées disponibles

  • accounts:read – Lecture des comptes de marketplace
  • items:read – Lecture des articles et de leurs annonces
  • items:write – Écriture sur les articles
  • orders:read – Lecture des commandes
  • conversations:read – Lecture des conversations
  • conversations:write – Écriture sur les conversations

Documentation de l'API

La référence interactive (Swagger) et la spécification OpenAPI sont publiques et générées depuis l'API en production.

L'API est versionnée (/api/public/v1). La v1 n'évolue que par ajouts ; en cas de rupture, une v2 est ouverte et la v1 reste disponible au moins douze mois après l'annonce.

SDK et CLI officiels

Des SDK générés depuis la spécification et une CLI, en open source sur GitHub.

Les paquets ne sont pas encore publiés : bientôt sur npm, PyPI et Maven Central. En attendant, le code source est disponible sur GitHub.