L'API d'export

Les plans qui incluent l'API permettent de lire vos réponses depuis vos propres outils (tableur, logiciel statistique, entrepôt de données). C'est en lecture seule et anonymisé : ni enquêteur, ni position, ni destinataire. Un texte libre peut contenir une identité : traitez-le avant de le diffuser.

Créer une clé

Le propriétaire de l'espace crée les clés dans Paramètres de l'espace, puis Accès API. La clé n'est montrée qu'une fois : copiez-la. Vous pouvez en créer dix au plus et les révoquer à tout moment ; une clé révoquée cesse de fonctionner aussitôt.

Appeler l'API

Envoyez la clé dans l'en-tête `Authorization: Bearer VOTRE_CLE`.

• Liste des enquêtes : `GET /api/v1/export/surveys`.
• Dictionnaire d'une enquête : `GET /api/v1/export/surveys/ID` : les questions (identifiant stable `uid`), leur type et leurs modalités (code et libellé).
• Réponses : `GET /api/v1/export/surveys/ID/responses`. Chaque réponse porte ses valeurs par `uid` de question : le code de la modalité pour un choix, une liste pour un choix multiple ou un classement, un nombre, un texte.

Lire par pages

La réponse contient `data` et `next_cursor`. Tant que `next_cursor` n'est pas vide, rappelez avec `cursor=<next_cursor>`. Le curseur suit l'ordre d'arrivée : aucune réponse n'est sautée ni répétée, même si de nouvelles arrivent pendant la lecture.

Options : `limit` (1 à 1000, 200 par défaut), `since` (date ou horodatage ISO 8601), `mode` (`ASSISTED` ou `SELF`), `scope` (`analysed`, par défaut, ou `all` pour inclure aussi les réponses partielles, rejetées ou renvoyées).

Limites

Cent vingt requêtes par minute et par clé. Au-delà, l'API répond 429 : patientez. Si votre plan cesse d'inclure l'API, les clés répondent 403 (`feature_not_included`) ; vos données restent exportables en fichier.

Voir aussi : exporter vos données.