API Almawarid

Démarrer en 3 étapes

Authentification

Limites, format et mode

Exemples

# Lire le catalogue avec les quantités en stock
curl -s https://almawarid.app/api/stock/products/?active=1 \
     -H "Authorization: Token VOTRE_JETON"

# Poser une entrée de stock (mode lecture/écriture requis)
curl -s -X POST https://almawarid.app/api/stock/move/ \
     -H "Authorization: Token VOTRE_JETON" \
     -H "Content-Type: application/json" \
     -d '{"product_id": 12, "delta": 10, "reason": "Réception fournisseur"}'

# pip install requests
import requests

BASE = "https://almawarid.app/api"
ENTETES = {"Authorization": "Token VOTRE_JETON"}

# 1) Lire le catalogue et les quantités
r = requests.get(f"{BASE}/stock/products/", headers=ENTETES,
                 params={"active": 1}, timeout=20)
r.raise_for_status()
for produit in r.json():
    print(produit["sku"], produit["name"], produit["quantity"])

# 2) Entrée de stock — nécessite le mode lecture/écriture
r = requests.post(f"{BASE}/stock/move/", headers=ENTETES, timeout=20,
                  json={"product_id": 12, "delta": 10,
                        "reason": "Réception fournisseur"})
if r.status_code == 403 and r.json().get("mode") == "lecture_seule":
    print("Clé en lecture seule : demandez le mode écriture.")
elif r.status_code == 429:
    print("Plafond atteint (20 appels/minute) : ralentissez.")
else:
    print(r.json())          # {"movement_id": 901, "quantity": 33.0}

<?php
$base    = 'https://almawarid.app/api';
$entetes = ['Authorization: Token VOTRE_JETON',
            'Content-Type: application/json'];

function appel($url, $entetes, $corps = null) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => $entetes,
        CURLOPT_TIMEOUT        => 20,
    ]);
    if ($corps !== null) {
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($corps));
    }
    $reponse = curl_exec($ch);
    $code    = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return [$code, json_decode($reponse, true)];
}

// 1) Catalogue + stock
list($code, $produits) = appel("$base/stock/products/?active=1", $entetes);
foreach ($produits as $p) {
    echo $p['sku'], ' ', $p['name'], ' ', $p['quantity'], PHP_EOL;
}

// 2) Entrée de stock (mode lecture/écriture requis)
list($code, $res) = appel("$base/stock/move/", $entetes,
    ['product_id' => 12, 'delta' => 10, 'reason' => 'Réception fournisseur']);
if ($code === 403 && ($res['mode'] ?? '') === 'lecture_seule') {
    echo "Clé en lecture seule : demandez le mode écriture.", PHP_EOL;
} elseif ($code === 429) {
    echo "Plafond atteint : 20 appels par minute.", PHP_EOL;
}

Ce que répond l'API