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

# Informations générales

> Authentification, pagination, ordre des résultats et limitation du débit de l'API REST poll&roll.

L'API REST de poll\&roll vous permet d'accéder par programmation à vos études, à leurs quotas, à leurs sources d'échantillon et au suivi de terrain. Toutes les requêtes se font sur l'URL de base suivante :

```
https://app.pollandroll.com/api/v1
```

## Authentification

Chaque requête doit fournir un **identifiant** et un **token** dans les en-têtes HTTP.

<ParamField header="Authorization-ID" type="integer" required>
  Votre identifiant (ex. `12456`).
</ParamField>

<ParamField header="Authorization-Token" type="string" required>
  Votre token secret (ex. `aa8f06f5864a58c09f0c5a60aa47650133a459dcc9c21504677914623e152674872786eb1b871c96c7fa87b3b800967f40b419a2abca4ff30acc73544f93dfb9`).
</ParamField>

<Warning>
  Votre token est secret. Ne le diffusez pas côté client (navigateur, application mobile) et ne le publiez pas dans un dépôt de code.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl https://app.pollandroll.com/api/v1/surveys \
    -H "Authorization-ID: 12456" \
    -H "Authorization-Token: aa8f06f5864a58c09f0c5a60aa47650133a459dcc9c21504677914623e152674..."
  ```
</RequestExample>

## Pagination

Tous les endpoints de type liste (`index`) sont paginés. Un objet `pagination` est renvoyé à la fin de la réponse :

```json theme={null}
"pagination": {
  "current_page": 1,
  "next_page": 2,
  "prev_page": null,
  "total_pages": 105,
  "total_count": 2088
}
```

Utilisez le paramètre de requête `page` pour parcourir les résultats.

<ParamField query="page" type="integer">
  Le numéro de la page demandée (ex. `https://app.pollandroll.com/api/v1/surveys?page=2`).
</ParamField>

## Ordre

Les enregistrements des listes sont triés selon leur champ `created_at`, par ordre **décroissant** (le plus récent en premier).

## Limitation du débit

Pour garantir une utilisation équitable et la stabilité de l'API, un plafond de débit s'applique à tous les endpoints. La limite par défaut est de **60 requêtes par minute**. Au-delà, l'API renvoie une réponse `429 Too Many Requests`.

<Tip>
  Bonnes pratiques :

  * Mettez en place un **backoff exponentiel** ou introduisez des délais lors du traitement des erreurs `429`.
  * Surveillez votre cadence de requêtes pour éviter d'atteindre la limite.
  * Contactez le support si vous avez besoin d'une limite plus élevée pour votre application.
</Tip>