---
title: Scénarios API
description: Tester les services REST et HTTP avec des steps API dans vos tests web et mobile.
sidebarTitle: API
lastUpdated: "2026-09-02"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Les tests API dans Kapptivate couvrent les services REST et HTTP : méthodes, headers, corps JSON, assertions sur les réponses, extraction de variables et timing détaillé par requête. Les actions API sont des steps à l'intérieur des tests web ou mobile, ajoutés depuis le [test builder](/fr/tests/builder) comme tout autre step ; l'action et les métriques sont identiques dans les deux cas, seul le type de test environnant diffère.

## Actions API

Les actions API HTTP sont disponibles dans les tests existants :

- **Dans un test web** : ajoutez des requêtes HTTP aux côtés des steps navigateur. Identifiant d'action : `ETH_HTTP_API`.
- **Dans un test mobile** : ajoutez des requêtes HTTP aux côtés des steps smartphone. Identifiant d'action : `DATA_API_HTTP`.

Les deux partagent la même configuration de requête et le même modèle d'assertion sur les réponses, avec quelques différences de routage spécifiques au canal.

Dans un test **Web (New experience)**, il s'agit du [step API Call](/fr/tests/actions/web/apicall) : la même requête, plus des conditions sur la réponse dans l'onglet Checks du step et une visualisation de la réponse dans le builder comme dans les résultats. `ETH_HTTP_API` reste ce que vous adressez dans les tests classiques et via le [CLI](/fr/cli/guides/create-tests) et le MCP.

## Configuration de la requête

- **Méthodes HTTP** : `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.
- **URL** avec variables templatisées.
- **Headers personnalisés** avec autocomplétion pour les headers standards.
- **Corps** : payload JSON ou brut.
- **Routage** : remplacement DNS, proxy, contournement SSL, conservation des cookies, gestion des redirections.

## Validation de la réponse

- Vérification du **code de statut**.
- Assertions sur le **corps** et les **headers**.
- **Extraction de variables** depuis la réponse pour utilisation dans les steps suivants.

## Métriques par requête

Chaque requête HTTP émet un détail de timing complet : résolution DNS, connexion TCP, handshake TLS, génération du contenu, transfert et total. Cela vous permet de repérer les régressions de performance, pas seulement les échecs fonctionnels.