Effectuer des requêtes

URL de base & en-têtes

https://app.solya.app/api/...

Envoyez JSON et votre bearer token :

curl https://app.solya.app/api/brands \
  -H "Authorization: Bearer solya_sa_…" \
  -H "Content-Type: application/json"

Pagination

Solya utilise deux schémas de pagination selon la famille de endpoints. Vérifiez toujours le endpoint dans l’onglet Référence API pour voir lequel s’applique.

Basée sur la page (la plupart des endpoints)
Basée sur le décalage (plateforme de données)

Paramètres de requête : page (indexé à 1) et pageSize.

curl "https://app.solya.app/api/collections?page=1&pageSize=20" \
  -H "Authorization: Bearer solya_sa_…"

Enveloppe de réponse :

{ "data": [ /* … */ ], "total": 8, "page": 1, "pageSize": 20 }

Paramètres de requête : limit et offset.

curl "https://app.solya.app/api/data-platform/tagging-rules?limit=50&offset=0" \
  -H "Authorization: Bearer solya_sa_…"

Enveloppe de réponse :

{ "items": [ /* … */ ], "limit": 50, "offset": 0 }

Filtrage & recherche

Les endpoints de liste acceptent les paramètres de requête pour filtrer les résultats (par exemple q pour la recherche textuelle sur les endpoints de catalogue, plus les filtres spécifiques au domaine comme variantId ou les plages de dates). Les paramètres exacts pour chaque endpoint sont documentés dans l’onglet Référence API, généré à partir de la spécification OpenAPI en direct.

Introspection de token

Utilisez GET /api/auth/whoami pour vérifier un token et lire son organisation et ses permissions effectives — consultez Authentification.

Limitation de débit

L’application n’applique actuellement pas de limites de débit de requête au niveau de l’API. Les limites peuvent être appliquées par l’infrastructure en frontal de l’API, donc écrivez des clients défensivement : respectez la sémantique HTTP standard et retournez-vous en cas de réponses 429. Consultez Codes d’erreur.

Intégration API

Recettes API

Plateforme & modèle de données

Couche décision (référence)

Exploitation & infrastructure

Specs d'ingestion (référence)

Workflows (référence)

Règles de tagging (référence)

Alertes (référence)

Effectuer des requêtes

URL de base & en-têtes

Filtrage & recherche

Introspection de token

Limitation de débit

​URL de base & en-têtes

​Pagination

​Filtrage & recherche

​Introspection de token

​Limitation de débit

URL de base & en-têtes

Pagination

Filtrage & recherche

Introspection de token

Limitation de débit