Référence API

Formiqa expose une petite API REST pour lire vos formulaires et vos réponses et pour créer des réponses par programmation. Chaque point de terminaison se trouve sous l'URL de base https://formiqa.app et les requêtes comme les réponses utilisent le JSON.

Authentification

Vous vous authentifiez en envoyant un jeton Bearer dans l'en-tête Authorization — c'est-à-dire un en-tête de la forme Authorization: Bearer <jeton>. Aujourd'hui, le jeton est votre jeton de session actuel, la même session qui vous authentifie dans l'application.

Points de terminaison

GET /api/v1/forms

Liste les formulaires de votre compte. Renvoie un tableau JSON de vos formulaires avec leurs métadonnées de base.

GET /api/v1/forms/{formId}

Récupère un formulaire unique par son identifiant, y compris sa configuration. Renvoie le formulaire sous forme d'objet JSON.

GET /api/v1/forms/{formId}/submissions

Liste les réponses d'un formulaire. Ce point de terminaison est paginé : parcourez les pages pour récupérer tout l'historique plutôt que de vous attendre à obtenir toutes les réponses en une seule fois.

POST /api/v1/forms/{formId}/submissions

Crée une réponse pour un formulaire, exactement comme si elle avait été remplie dans le navigateur. Il valide les champs requis et vérifie le quota de votre offre avant d'accepter la réponse : un appel peut donc être rejeté si une réponse requise manque ou si vous avez atteint votre limite de réponses.

Réponses

Toutes les réponses sont au format JSON. Une lecture réussie renvoie la ressource demandée ; un POST réussi renvoie la réponse créée. Lorsqu'une requête ne peut aboutir — un champ requis manquant, ou un quota d'offre atteint — l'API répond avec un statut d'erreur et un corps JSON décrivant le problème, afin que vous puissiez l'afficher ou réessayer de façon appropriée.