Aller au contenu

Documentation

Développez à partir devotre propre boutique

Une API REST sur les mêmes données que le tableau de bord : produits, stock, commandes, clients et paiements, avec des webhooks à chaque changement.

Aperçu

La référence complète n’est pas encore publique. Ce qui suit décrit fidèlement l’API telle qu’elle existe aujourd’hui ; l’accès est accordé par boutique, sur demande.

Premiers pas

Trois choses avant votre première requête

01

Créer une boutique

L’API est rattachée à une boutique. Ouvrez-en une avec le forfait gratuit si vous n’en avez pas encore.

Créer une boutique
02

Demander l’accès

L’accès à l’API est activé boutique par boutique. Indiquez-nous la boutique et ce que vous développez.

Demander l’accès
03

Générer une clé

Créez une clé à portée limitée depuis le tableau de bord, puis envoyez-la comme jeton Bearer.

Voir le modèle d’authentification

Votre première requête

Chaque appel se compose d’un jeton Bearer et d’un chemin rattaché à la boutique. Les réponses sont en JSON et les listes sont paginées.

Voir les clés, portées et limites
bash
curl https://api.securemarts.com/v1/products \
  -H "Authorization: Bearer $SECUREMARTS_API_KEY" \
  -H "Content-Type: application/json"

Couverture

Ce que l’API couvre

Les mêmes données que celles lues et écrites par le tableau de bord. Rien ici n’est une copie séparée de vos données pour le reporting.

Catalogue et stock

Lisez et modifiez les produits, variantes, collections et niveaux de stock par point de vente.

Commandes et expédition

Listez les commandes, faites-les avancer, rattachez-y des livraisons et enregistrez les retours.

Clients

Fiches clients, adresses, historique des commandes et appartenance aux segments.

Paiements et factures

Paiements, factures, remboursements et documents associés.

Webhooks

Abonnez-vous aux événements de commande, de stock, de paiement et de client, avec des charges utiles signées.

Données de la boutique en ligne

Données de catalogue et de thème en lecture seule pour créer une boutique en ligne sur mesure.

Questions des développeurs

Consulter le centre d’aide

Non. L’accès à l’API dépend du forfait et s’active boutique par boutique. Si votre forfait l’inclut, vous pouvez générer des clés depuis le tableau de bord ; sinon, la marche à suivre pour changer de forfait est sur la page Tarifs.

Me prévenir quand la référence sera publique