Recettes API - Solya Docs

Exemples pratiques et exécutables pour les flux d’intégration les plus courants. Ils s’appuient sur les concepts présentés dans Intégration API — URL de base, authentification, pagination et l’enveloppe de réponse.

Lire des données

Lister le catalogue, paginer et lire les risques de rupture de stock.

Créer un plan

Créer un plan de réassort et ajouter un article — le flux d’écriture.

Avant de commencer

URL de base — https://app.solya.app ; les endpoints sont sous /api/.
Authentification — chaque requête porte l’en-tête Authorization: Bearer solya_sa_… (un token de compte de service).
Enveloppe — les réponses d’écriture/action utilisent { "success": true, "data": … } ou { "success": false, "errorCode": … }. Branchez sur errorCode, pas sur le texte. Voir Codes d’erreur.

Vérifiez votre token

Un appel rapide confirme que le token se résout sur la bonne organisation et ses permissions.

cURL
Python
JavaScript

curl https://app.solya.app/api/auth/whoami \
  -H "Authorization: Bearer solya_sa_xxx"

import requests

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

r = requests.get(f"{BASE}/api/auth/whoami", headers=headers)
r.raise_for_status()
print(r.json())  # { authKind, organizationId, effectivePermissions, ... }

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

const res = await fetch(`${BASE}/api/auth/whoami`, { headers })
if (!res.ok) throw new Error(`whoami failed: ${res.status}`)
console.log(await res.json())

Préférez ne pas écrire les requêtes à la main ? Pointez un agent IA vers la passerelle MCP et il découvrira et appellera ces endpoints pour vous.

Codes d'erreur & réponses Recette — lire des données

⌘I

Lire des données

Créer un plan

​Avant de commencer

​Vérifiez votre token

Avant de commencer

Vérifiez votre token