Informations générales - Guide utilisateur 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.

integer

required

Votre identifiant (ex. 12456).

string

required

Votre token secret (ex.

aa8f06f5864a58c09f0c5a60aa47650133a459dcc9c21504677914623e152674872786eb1b871c96c7fa87b3b800967f40b419a2abca4ff30acc73544f93dfb9

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.

curl https://app.pollandroll.com/api/v1/surveys \
  -H "Authorization-ID: 12456" \
  -H "Authorization-Token: aa8f06f5864a58c09f0c5a60aa47650133a459dcc9c21504677914623e152674..."

Pagination

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

"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.

integer

Le numéro de la page demandée (ex. https://app.pollandroll.com/api/v1/surveys?page=2).

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.

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.

​Authentification

​Pagination

​Ordre

​Limitation du débit

Authentification

Pagination

Ordre

Limitation du débit