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, puis en cliquant sur un des attributs.

Vous pouvez cliquer sur l'icône à côté de l'ID pour le copier en un clic.

Les ID des blocs

Dans le studio, en sélectionnant un bloc depuis la hiérarchie ou le panneau central, cliquez sur l'icone correspondant aux paramètres du bloc.

De là vous aurez accès à l'ID du bloc, qu'il est aussi possible de copier/coller en un clic.

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, n8n 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.

Vous pouvez utiliser la syntaxe suivante pour un attribut ayant plusieurs valeurs, la syntaxe par défaut n'acceptant qu'une seule valeur.

{
    "Attribut": "{{attributes["attribute_id"] | string | escape_json }}"
}

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 : 18/07/2025

Cet article a-t-il répondu à vos questions ?

Merci !