Endpoint API

Appelle un endpoint API enregistre dans l'API Manager du workspace. Reutilise la configuration (auth, headers) definie dans le catalogue.

Parametres

Parametre	Type	Requis	Variable	Description
endpointId	texte	Oui	Oui	Identifiant de l'endpoint API selectionne depuis le catalogue.
endpointPath	texte	Non	Non	Chemin de l'endpoint (ex: /api/queries/nodes). Rempli automatiquement lors de la selection.
method	choix (GET, POST, PUT, PATCH, DELETE)	Oui	Non	Methode HTTP de la requete.
category	texte	Non	Non	Categorie de l'endpoint (queries, commands, health, etc.).
description	texte	Non	Non	Description de l'endpoint.
apiKeyConfig	objet	Non	Non	Configuration de la cle API pour l'authentification.
requestBody	valeur dynamique	Non	Oui	Corps de la requete (pour les methodes POST, PUT, PATCH). Peut etre une valeur fixe ou une variable.
headers	liste	Non	Non	En-tetes HTTP de la requete (paires cle/valeur dynamiques).
queryParams	liste	Non	Non	Parametres de requete URL (paires cle/valeur dynamiques).
pathParams	liste	Non	Non	Parametres de chemin extraits automatiquement des motifs :param dans l'URL.
timeout	nombre	Non	Non	Delai d'expiration de la requete en millisecondes.
retryOnError	oui/non	Non	Non	Retenter automatiquement la requete en cas d'erreur. (Defaut: false)
maxRetries	nombre	Non	Non	Nombre maximum de tentatives en cas d'erreur. (Defaut: 1, min 1, max 10)

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Sortie

Variable de sortie : apiEndpointResult

{
  "success": false,
  "statusCode": 0,
  "headers": {},
  "body": "...",
  "rawBody": "...",
  "responseTimeMs": 0,
  "contentLength": 0,
  "endpoint": {}
}

Exemple

Appeler un endpoint pre-configure.

Entree :

{"endpointId": "ep-crm-leads"}

Sortie :

{"success": true, "statusCode": 200, "headers": {"content-type": "application/json"}, "body": [{"id": 1, "name": "Acme"}], "rawBody": "[{\"id\":1,\"name\":\"Acme\"}]", "responseTimeMs": 245, "contentLength": 32, "endpoint": {"id": "ep-crm-leads", "name": "CRM Leads"}}

Astuce

Preferer ce bloc a http_request pour les APIs frequemment utilisees : la configuration d'authentification est centralisee dans l'API Manager.