Lister les soumissions de formulaire avec l'API Webflow
Liste les soumissions d'un formulaire, avec les réponses dans formResponse et la date dans dateSubmitted. La réponse contient pagination avec limit, offset et total : la dernière page est celle où offset plus limit atteint total.
- Identifiant
- webflow_list_form_submissions
L'appel
POST https://connect.reportei.com/api/tools/webflow_list_form_submissions/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"form_id": "<form_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| form_id | string | Oui | Id of the form, from List forms. |
| limit | integer | Non | Submissions per page, up to 100. |
| offset | integer | Non | How many submissions to skip, for the next pages. |
Connexions possibles
Votre client connecte son compte Webflow une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/webflow, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/webflow_list_form_submissions. Il devient la définition de tool de votre agent sans conversion.
Autres tools Webflow
- Lister les sitesGETListe les sites accessibles à la connexion, avec l'id que demandent les autres outils comme site_id et les customDomains de chaque site avec leurs ids. Un jeton de site n'atteint que son propre site.
- Publier le sitePOSTPublie le site avec toutes ses modifications en attente sur les domaines choisis. Envoyez customDomains, publishToWebflowSubdomain ou les deux. Webflow autorise une publication réussie par minute.
- Lister les collectionsGETListe les collections CMS d'un site, avec l'id que demandent les outils d'éléments comme collection_id.
- Obtenir une collectionGETRenvoie une collection avec ses champs : le slug, le type et isRequired de chacun. Les slugs des champs sont les clés de fieldData dans Créer un élément de collection et Modifier un élément de collection.
- Lister les éléments d'une collectionGETListe les éléments d'une collection tels qu'ils sont avant publication, brouillons compris, avec fieldData indexé par le slug du champ. La réponse contient pagination avec limit, offset et total : la dernière page est celle où offset plus limit atteint total.
- Obtenir un élément de collectionGETRenvoie un élément d'une collection tel qu'il est avant publication, avec son fieldData, isDraft et isArchived.
- Créer un élément de collectionPOSTCrée un élément dans une collection et le renvoie. L'élément est un brouillon sauf si isDraft vaut false, ce qui le met en file pour la prochaine publication du site. Pour le mettre en ligne tout de suite, utilisez Publier des éléments de collection.
- Modifier un élément de collectionPATCHModifie un élément d'une collection et le renvoie. Seuls les champs envoyés dans fieldData changent. Les modifications d'un élément déjà en ligne atteignent le site avec Publier des éléments de collection ou Publier le site.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
