Recette — lire des données

Tous les exemples supposent la configuration de Recettes API (URL de base, token bearer).

Lister les marques (pagination basée sur la page)

GET /api/brands prend page, pageSize et une recherche optionnelle q ; il retourne l’enveloppe { data, total, page, pageSize }.

cURL
Python
JavaScript

curl "https://app.solya.app/api/brands?page=1&pageSize=20&q=adi" \
  -H "Authorization: Bearer solya_sa_xxx"

import requests
BASE, TOKEN = "https://app.solya.app", "solya_sa_xxx"
headers = {"Authorization": f"Bearer {TOKEN}"}

def list_brands(page=1, page_size=20, q=None):
    params = {"page": page, "pageSize": page_size}
    if q: params["q"] = q
    r = requests.get(f"{BASE}/api/brands", headers=headers, params=params)
    r.raise_for_status()
    return r.json()  # { data, total, page, pageSize }

first = list_brands(q="adi")
print(first["total"], len(first["data"]))

const BASE = "https://app.solya.app", TOKEN = "solya_sa_xxx"
const headers = { Authorization: `Bearer ${TOKEN}` }

async function listBrands({ page = 1, pageSize = 20, q } = {}) {
  const url = new URL(`${BASE}/api/brands`)
  url.searchParams.set("page", page)
  url.searchParams.set("pageSize", pageSize)
  if (q) url.searchParams.set("q", q)
  const res = await fetch(url, { headers })
  if (!res.ok) throw new Error(`brands failed: ${res.status}`)
  return res.json() // { data, total, page, pageSize }
}

Exemple de réponse :

{
  "data": [
    { "id": "brand-uuid-adidas", "name": "Adidas", "code": "ADI", "isActive": true }
  ],
  "total": 1, "page": 1, "pageSize": 20
}

Paginer sur tous les résultats

def all_brands():
    page, out = 1, []
    while True:
        res = list_brands(page=page, page_size=100)
        out.extend(res["data"])
        if page * res["pageSize"] >= res["total"]:
            break
        page += 1
    return out

Certains endpoints (principalement sous /api/data-platform/) utilisent la pagination basée sur le décalage (limit / offset) et retournent { items, limit, offset }. Vérifiez l’endpoint dans l’onglet Référence API. Voir Faire des requêtes.

Lire les risques de rupture de stock

GET /api/inventory/risks retourne les variantes classées par urgence, filtrables par status, brandIds, shopIds et period.

cURL
Python
JavaScript

curl "https://app.solya.app/api/inventory/risks?status=critical&pageSize=50" \
  -H "Authorization: Bearer solya_sa_xxx"

r = requests.get(
    f"{BASE}/api/inventory/risks",
    headers=headers,
    params={"status": "critical", "pageSize": 50},
)
r.raise_for_status()
for row in r.json()["data"]:
    print(row["rank"], row["variantName"], row["daysOfSupply"], row["status"])

const url = new URL(`${BASE}/api/inventory/risks`)
url.searchParams.set("status", "critical")
url.searchParams.set("pageSize", "50")
const res = await fetch(url, { headers })
const { data } = await res.json()
data.forEach(r => console.log(r.rank, r.variantName, r.daysOfSupply, r.status))

Chaque ligne inclut variantId, variantName, brandName, closingStock, avgDailySales, daysOfSupply et status (critical / warning / healthy). Voir le guide des risques de rupture. Pour agir sur une ligne critique, transformez-la en plan — recette suivante.

​Lister les marques (pagination basée sur la page)

​Paginer sur tous les résultats

​Lire les risques de rupture de stock

Lister les marques (pagination basée sur la page)

Paginer sur tous les résultats

Lire les risques de rupture de stock