> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Effectuer des requêtes

> URL de base, schémas de pagination, filtrage et introspection de token.

## URL de base & en-têtes

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

Envoyez JSON et votre bearer token :

```bash theme={null}
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.

<Tabs>
  <Tab title="Basée sur la page (la plupart des endpoints)">
    Paramètres de requête : `page` (indexé à 1) et `pageSize`.

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

    Enveloppe de réponse :

    ```json theme={null}
    { "data": [ /* … */ ], "total": 8, "page": 1, "pageSize": 20 }
    ```
  </Tab>

  <Tab title="Basée sur le décalage (plateforme de données)">
    Paramètres de requête : `limit` et `offset`.

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

    Enveloppe de réponse :

    ```json theme={null}
    { "items": [ /* … */ ], "limit": 50, "offset": 0 }
    ```
  </Tab>
</Tabs>

## 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](/fr/developers/authentication#vérifiez-qui-vous-êtes).

## 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](/fr/developers/error-codes).