> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/reference/blocs/api-request.md).

# Requête API

**Catégorie** — API

Appelle un service HTTP et expose son statut, sa réponse et des champs JSON sélectionnés.

![Requête API dans le builder](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-239e0e28a105eebbeeb59e317cd57711cb71c114%2Fapi-request.png?alt=media)

## Paramètres

| Réglage                | Valeurs acceptées                                                      |
| ---------------------- | ---------------------------------------------------------------------- |
| Nom                    | 1 à 40 caractères, lettre initiale, lettres/chiffres/underscores.      |
| Méthode et URL         | GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS. HTTP(S) selon le mode. |
| Paramètres et en-têtes | Jusqu’à 40 paires chacun.                                              |
| Corps                  | Texte, jusqu’à 64 000 caractères, selon la méthode.                    |
| Options                | Délai en ms entre 1 000 et 30 000.                                     |
| Test & résultats       | Test via l’agent et jusqu’à 50 champs JSON nommés.                     |
| URL HTTPS approuvées   | Dans les outils, une par ligne si l’URL est dynamique.                 |

## Entrées, sorties et variables

Une entrée et une sortie. Pour `etat` : `{etat_status-code}`, `{etat_status-text}`, `{etat_response}` et `{etat_mon_champ}`. Utilisez un secret dans les champs prévus.

## Exécution et limites

Les outils limitent les requêtes à GET ou HEAD et à des destinations HTTPS approuvées. Le résultat peut alimenter Comparaison ou Renvoyer un résultat.

## Exemple

Avec une API d’état de votre choix, faites un GET, puis comparez `{etat_status-code}` à `200` avant d’afficher le résultat.

## Erreurs courantes

Vérifiez URL, méthode, clé, disponibilité de l’agent et présence du chemin JSON sélectionné. Les destinations non autorisées sont refusées.

## Blocs associés

[Comparaison](/reference/blocs/comparison-condition.md) · [Envoyer un message](/reference/blocs/send-message.md) · [Renvoyer un résultat](/reference/blocs/return-tool-result.md)
