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)
- Allez dans Paramètres → Paramètres du site → Site web et API et cliquez sur Créer une clé API.
- Nommez-la (ex. « Mon site ») et choisissez Lecture seule (produits et stock) ou Lecture et commandes.
- 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=0 | Produits : 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,AF000002 | Stock et prix de 200 produits au maximum (ou ?barcode=). |
POST /orders | Cré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}/cancel | Annule 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.