> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟪 Requête HTTP

# 🟪 Requête HTTP

${frame}[Vidéo : anatomie du bloc Requête HTTP](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/http.html)

![Requête HTTP](https://celestory-docs-illustrations.netlify.app/fr/RequeteHTTP_FR.svg)

Le bloc Requête HTTP permet d'appeler directement un service web externe qui propose une API, sans passer par une intégration déjà prête (Airtable, Baserow, Zapier...). Il gère les méthodes GET, POST, PUT, DELETE et PATCH (les façons standard de lire, créer, remplacer, supprimer ou modifier une donnée sur le web).

C'est le bloc le plus simple mais aussi le plus "brut" pour connecter Celestory à un service extérieur : une API météo, un service de paiement, un serveur interne à votre entreprise, une IA qui n'a pas d'intégration officielle, etc. Il demande un peu plus de configuration qu'une intégration prête à l'emploi, mais il fonctionne avec n'importe quel service. Ce bloc est réservé aux abonnements Business.

## 📥 Entrées

-   méthode (Choix) : GET (lire), POST (créer), PUT (remplacer), DELETE (supprimer) ou PATCH (modifier partiellement). Valeur par défaut : POST.
-   url (Texte) : L'adresse complète du service à appeler (ex : `https://api.exemple.com/joueurs`).
-   type de contenu (Texte) : Précise le format des données envoyées (ex : `application/json`). Valeur par défaut : `application/json`.
-   corps (Texte) : Le contenu à envoyer avec la requête (généralement une chaîne JSON, souvent produite par un bloc Objet vers JSON), utilisé pour POST, PUT et PATCH.

## 📤 Sorties

-   out (Flux) : S'active une fois la requête terminée, pour poursuivre le scénario.
-   résultat (Texte) : La réponse brute renvoyée par le service, en texte.
-   objet (Objet) : La même réponse lue comme du JSON, prête à être utilisée dans le graphe (objet vide si la réponse n'est pas du JSON).

## 💡 Exemple d'utilisation

${frame}[Vidéo : le bloc Requête HTTP](https://celestory-docs-videos.netlify.app/fr/graphe-blocs/requete-http.html)

**Scénario : Envoyer le score final d'un joueur vers un backend interne**

1. Une partie se termine avec un score de 850 points, stocké dans un objet `resultat`.
2. Un bloc Objet vers JSON convertit `resultat` en chaîne JSON.
3. Un bloc Requête HTTP est configuré en méthode POST, avec l'url du backend interne et la chaîne JSON connectée à l'entrée `corps`.
4. Une fois la requête terminée, la sortie `out` déclenche un message de confirmation, et la sortie `objet` contient la réponse envoyée par le serveur.

## ⚙️ Détails Techniques

-   **Identifiant interne** : `http`
-   **Pas d'en-têtes personnalisés** : le bloc n'a aucun champ d'en-têtes, il n'envoie que `Content-Type`. Une API qui exige une clé dans un en-tête (`Authorization`, `x-api-key`…) ne peut pas être appelée directement : passez par un relais (ex : Voltask).
-   **Différence avec Voltask Webhook et Connecteur** : Ce bloc appelle directement une adresse web sans passer par le moteur d'automatisation Voltask ; il convient pour des appels API simples et ponctuels, alors que Voltask Webhook/Zapier/Make conviennent mieux à des automatisations plus complexes, en plusieurs étapes.
-   **Sécurité** : Évitez d'exposer des clés d'API sensibles en clair (dans l'url ou le corps de la requête) sur un projet destiné à être publié publiquement ; privilégiez, quand c'est possible, un appel relayé par un serveur (ex : via Voltask).

## 🔗 Voir aussi

-   **Connecteur** : pour fusionner des chemins dans le graphe, sans appel réseau.
-   **Voltask Webhook** : pour un envoi simple et optimisé vers l'écosystème Voltask.
-   **Zapier** / **Make** : pour déclencher une automatisation multi-étapes sans configurer vous-même l'appel HTTP.

---

*Version documentée : v3*