API des tunnels : clés fk_… et ressources

Créer une clé, l’utiliser et connaître les ressources et codes de réponse.

À quoi ça sert

Piloter vos tunnels et y ajouter des contacts depuis une autre application.

Notions de développement.

Ouvrez « Paramètres › Connexions », section « Clés d’API ».
Saisissez un « Nom de la clé », cliquez sur « Créer une clé d’API » et copiez la clé fk_… tout de suite.
Appelez api.php?r=<ressource> avec l’en-tête Authorization: Bearer fk_….
Ressources : templates, products, funnels, funnel, pages, page, leads, lead, stats, hooks, usage, duplicate.
Pour ajouter un contact : POST api.php?r=lead&id=<numéro du tunnel> avec {"nom":"…","email":"…","consent":true,"tags":["…"]}.
Pour retirer l’accès, cliquez sur « Révoquer ».

Réponses JSON. 402 si le forfait est dépassé, 429 au-delà de 300 requêtes par 15 minutes et par clé.

consent doit être true : la personne doit avoir accepté de recevoir vos courriels.
Les clés d’API sont comptées sans limite de forfait, mais les contacts et tunnels créés suivent les quotas.

401 « Clé d’API manquante ou invalide. »

En-tête absent ou clé révoquée.

422 « Le consentement du contact… (consent: true) est requis. »

Ajoutez "consent": true si le contact a vraiment consenti.

402 quota_exceeded

Limite de tunnels ou de contacts atteinte.

404 « Tunnel introuvable. »

Le paramètre id ne correspond à aucun tunnel de votre compte.