Données · Étape

Appeler une API `http.call`

Envoie une requête HTTP depuis le robot et enregistre la réponse (statut, corps, JSON).

Type: http.call
Famille: Données
Exécuté par: Robot
Quand l’utiliser: Intégrer une API REST : créer un dossier, lire un statut, déclencher un service.

Synopsis

{
  "id": "api",
  "type": "http.call",
  "label": "Créer le dossier",
  "props": {
    "method": "POST",
    "url": "https://api.exemple.fr/v1/dossiers",
    "body": "{\"client\": \"{{client}}\"}",
    "credential": "API Dossiers",
    "auth": "bearer",
    "into": "reponse"
  }
}

Propriétés

Toutes les valeurs s’écrivent en chaînes JSON et acceptent l’interpolation {{variable}}. Voir Objet Étape.

Propriété	Type	Requis	Défaut	Description
`method`	énumération	non	`GET`	Méthode HTTP. `GET` `POST` `PUT` `PATCH` `DELETE`
`url`	url	oui	—	Adresse appelée. Ex. `https://api.exemple.fr/v1/dossiers`
`headers`	texte	non	—	En-têtes « Nom: valeur » (un par ligne) ou objet JSON.
`body`	texte	non	—	Corps : JSON (envoyé en application/json) ou texte brut. Ex. `{"numero": "{{numero}}"}`
`credential`	texte	non	—	Identifiant du Coffre utilisé pour l'authentification.
`auth`	texte	non	`bearer`	Mode d'authentification avec « credential » : bearer, basic, ou header:Nom-En-Tête. Ex. `header:X-API-Key`
`into`	variable	non	`reponse`	Variable de réponse.

Résultat

Variable: reponse — modifiable par into
Nature: objet
Contenu: Réponse HTTP. Voir l’objet Réponse HTTP.

Remarques

Un statut ≥ 400 ne fait pas échouer l'étape : testez {{reponse.status}} avec flow.if.
Le corps est tronqué à 20 000 caractères.

Erreurs fréquentes

Message	Cause	Solution
`JSON invalide`	« headers » commence par { mais n'est pas un JSON valide.	Corrigez le JSON ou utilisez le format « Nom: valeur ».

Voir aussi

Source : orchestrator/zokas_orch/runtime.py — PackageRunner._http ; robot/zokas_robot/server.py — http_request

Mis à jour le 28 octobre 2026