Blocs Appel d'API

Pré-requis

Pour émettre du contenu via le bloc Appel d’API vous aurez besoin :

Que le bloc soit parent des blocs à exporter
Des ID des attributs que vous souhaitez utiliser
Des ID des blocs dont vous souhaitez récupérer le contenu

Le bloc Appel d’API n’a pas besoin d’être directement parent de chaque bloc à exporter, il doit simplement être parent et avoir en son sein, même si c’est plusieurs étages d’imbrications en dessous, les blocs de contenu à émettre.

1. Récupération des ID

Commencez par récupérer les ID des attributs et blocs que vous souhaitez exporter.

Les ID des attributs


Les attributs vous permettent d’envoyer à Thinkeo vos fichiers et vos données à utiliser dans l’App.

Vous pourrez retrouver leurs ID dans la page Attributs.



Au survol sur une ligne une icône vous permettant de copier l’ID en un clic apparaitra.

Les ID des blocs


Quand vous ouvrez un bloc dans un nouvel onglet, vous pourrez récupérer son UUID dans l’URL de votre navigateur.

Par exemple : thinkeo.io/block/0191eabd-48cb-7de1-9e2c-ae53281cf173

Pour ce faire cliquer sur les “…” d’un bloc depuis l’arborescence, sélectionnez “ouvrir dans un nouvel onglet” puis récupérer l’ID.

2. Paramétrage du bloc Appel d’API

Vous pouvez modifier tous ces champs depuis les paramètres du bloc.

Le Bloc API ne supporte pas les méthodes d’authentification complexe mais vous permettra de réaliser, par exemple, des POST vers des webhook ou des API utilisant une méthode d’authentification en Bearer Token.



Vous aurez à choisir la Méthode, spécifier l'URL cible, les En-têtes et et ajouter au format JSON le Corps approprié.


Pensez à spécifier le type de contenu émis par le bloc, nous préconisons “application/json” qui correspond à la majorité des usages, particulièrement si vous êtes utilisateurs de Make ou Zapier.


Pour le corps (Body) du Bloc, voilà la syntaxe à respecter pour récupérer le contenu d'un attribut ou d’un bloc :

{
    "Attribut": "{{attributes["attribute_id"] | escape_json }}",
    "Bloc": "{{blocks["block_id"] | escape_json }}"
}

Dans cet exemple, on exporterait la valeur d'un attribut et le contenu d'un bloc.

"Attribut" et "Bloc" sont donc les clés qui peuvent être renommées selon vos besoins.

Ici, attribute_id est à remplacer par l'ID de l'attribut disponible dans l'Éditeur d'attributs. Cela vous permet de récupérer la valeur de l'attribut concerné.

Le block_id est l'uuid mentionné dans l'URL du navigateur, une fois le bloc ouvert dans un nouvel onglet.

Il convient de toujours ajouter | escape_json pour éviter les erreurs de syntaxe lors de l'export via le Call API.

💡Le contenu des blocs est au format HTML, le contenu des attributs au format String. Ces deux formats ne sont pas modifiables.


⚠️ Un bloc Appel d'API doit être exécuté depuis une Étape du Wizard. Il convient de l'assigner à une Étape bloquante pour s'assurer que tous les blocs ont bien été exécutés avant de déclencher l'exécution de l'Appel API. Vous pouvez consulter l'article dédié au Wizard sur la documentation des Apps.

3. URL, En-têtes et Query

L’URL et les En-têtes supportent l’utilisation d’attributs comme variable dynamique. Vous pouvez donc utiliser la syntaxe suivante pour alimenter ces champs :

{{attributes["attribute_id"] | escape_json }}

Si vous souhaitez ajouter des query parameters à votre URL, vous pouvez utiliser une syntaxe de ce type :

https://thinkeo.io/urlcible?queryparameter1={{attributes['attribute_id'] | escape_json }}&queryparameter2={{attributes['attribute_id'] | escape_json }}

Dans cet exemple, l’URL est à remplacer par l’endpoint cible et “queryparameter” par la key à utiliser pour votre API.

⚠️ Les blocs exportent un contenu en HTML, il n’est donc pas possible de les utiliser comme variable dans les champs URL et En-têtes. Vous pouvez alimenter les attributs via un étape "saisie libre" de votre wizard ou une étape "réponses prédéfinies".

Mis à jour le : 31/01/2025