Ventes en ligne

Connecter votre site (API)

Votre propre site (WooCommerce, Shopify, site sur mesure…) peut afficher vos produits avec leur stock réel et envoyer ses commandes à AFASIN Pro. Donnez à votre développeur une clé API et cette page.

1. Créer une clé (administrateur de la boutique)
  1. Allez dans Paramètres → Paramètres du site → Site web et API et cliquez sur Créer une clé API.
  2. Nommez-la (ex. « Mon site ») et choisissez Lecture seule (produits et stock) ou Lecture et commandes.
  3. Copiez la clé tout de suite (elle commence par afk_) : elle n'est affichée qu'une fois. Révoquez-la depuis la même page si elle a fuité.
2. Appeler l'API (développeur)

URL de base https://pro.afasin.com/api/v1, en-tête Authorization: Bearer afk_…, JSON en entrée et en sortie. Appelez-la uniquement depuis le serveur du site. Limite : 120 requêtes par minute et par clé.

GET /products?updated_since=…&limit=100&offset=0Produits : sku, barcode, name, description, category, sub_category, brand, unit, price, stock, image_url, variant_of, variant_values. Avec updated_since, les produits retirés reviennent avec "active": false.
GET /products/{sku}Un produit par SKU, code-barres ou identifiant.
GET /stock?sku=AF000001,AF000002Stock et prix de 200 produits au maximum (ou ?barcode=).
POST /ordersCrée une commande et prélève le stock. Répond 409 insufficient_stock si un produit manque, 409 duplicate si la référence a déjà été envoyée.
GET /orders/{ref}Statut : new, accepted, ready, shipped, completed, cancelled ou refused.
POST /orders/{ref}/cancelAnnule une commande pas encore expédiée (le stock revient).

Exemple de commande :

curl -X POST https://pro.afasin.com/api/v1/orders \
  -H "Authorization: Bearer afk_…" -H "Content-Type: application/json" \
  -d '{ "external_ref": "WC-1042", "fulfilment": "delivery",
        "customer": { "name": "Awa Diop", "email": "awa@example.com", "phone": "0600000000" },
        "delivery": { "address": "12 rue …", "postal_code": "68100", "city": "Mulhouse", "country": "FR" },
        "items": [ { "sku": "AF000092", "quantity": 2 } ], "shipping": 4.90 }'
Prix : un article sans unit_price prend votre prix AFASIN Pro. Les produits à variantes se commandent avec le SKU de la variante.

Ce guide vous parle ? Essayez AFASIN Pro gratuitement dans votre commerce.

Créer mon compte
4 129 produits
Photos, codes-barres, ingrédients
11 fournisseurs
Prix comparés, commandes groupées
1 443 commerces
Épiceries et restaurants par ville
Caisse conforme
Gratuite pour démarrer