[comment]: # translation:outdated

[comment]: # ({a17bb95b-a17bb95b})
# > Objet Scenario Web

Les objets suivants sont directement liés à l'API `webcheck`.

[comment]: # ({/a17bb95b-a17bb95b})

[comment]: # ({de411d0c-e60908bb})
### Scénario Web

L'objet de scénario Web possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|httptestid|string|*(lecture seule)* ID du scénario Web.|
|**hostid**<br>(obligatoire)|string|ID de l'hôte auquel appartient le scénario Web.|
|**name**<br>(obligatoire)|string|Nom du scénario Web.|
|agent|string|Chaîne de l'agent utilisateur qui sera utilisée par le scénario Web.<br><br>Par défaut : Zabbix|
|authentication|integer|Méthode d'authentification qui sera utilisée par le scénario Web.<br><br>Valeurs possibles :<br>0 - *(par défaut)* aucune ;<br>1 - authentification HTTP de base ;<br>2 - Authentification NTLM.|
|delay|string|Intervalle d'exécution du scénario Web. Accepte les secondes, l'unité de temps avec suffixe et la macro utilisateur.<br><br>Par défaut : 1 m.|
|headers|tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|En-têtes HTTP qui seront envoyés lors de l'exécution d'une requête.|
|http\_password|string|Mot de passe utilisé pour l'authentification HTTP ou NTLM de base.|
|http\_proxy|string|Proxy qui sera utilisé par le scénario Web donné comme *http://\[username\[:password\]@\]proxy.example.com\[:port\]*.|
|http\_user|string|Nom d'utilisateur utilisé pour l'authentification HTTP ou NTLM de base.|
|nextcheck|timestamp|*(lecture seule)* Heure de la prochaine exécution du scénario Web.|
|retries|integer|Nombre de fois qu'un scénario Web tentera d'exécuter chaque étape avant d'échouer.<br><br>Par défaut : 1.|
|ssl\_cert\_file|string|Nom du fichier de certificat SSL utilisé pour l'authentification du client (doit être au format PEM).|
|ssl\_key\_file|string|Nom du fichier de clé privée SSL utilisé pour l'authentification du client (doit être au format PEM).|
|ssl\_key\_password|string|Mot de passe de la clé privée SSL.|
|status|integer|Indique si le scénario Web est activé.<br><br>Les valeurs possibles sont :<br>0 - *(par défaut)* activé ;<br>1 - désactivé.|
|templateid|string|*(lecture seule)* ID du scénario Web du modèle parent.|
|variables|tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|Variables de scénario Web.|
|verify\_host|integer|Indique s'il faut vérifier que le nom d'hôte spécifié dans le certificat SSL correspond à celui utilisé dans le scénario.<br><br>Les valeurs possibles sont :<br>0 - *(par défaut)* ignorer la vérification de l'hôte ;<br>1 - vérifier l'hôte.|
|verify\_peer|integer|Indique s'il faut vérifier le certificat SSL du serveur Web.<br><br>Les valeurs possibles sont :<br>0 - *(par défaut)* ignorer la vérification par l'homologue ;<br>1 - vérifier l'homologue. |
|uuid|string|*(lecture seule sur les scénarios Web déjà existants)*<br>Identifiant unique global, utilisé pour lier les scénarios Web importés à ceux déjà existants. Utilisé uniquement pour les scénarios Web sur des modèles.|

Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.

[comment]: # ({/de411d0c-e60908bb})

[comment]: # ({77f50b6b-c7ab7fb0})
### Tag de scénario Web

L'objet tag de scénario Web possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**tag**<br>(obligatoire)|string|Nom du tag du scénario Web.|
|value|string|Valeur du tag du scénario Web.|

[comment]: # ({/77f50b6b-c7ab7fb0})

[comment]: # ({bec454ad-eb20f47d})
### Étape du scénario

L'objet d'étape de scénario définit une vérification de scénario Web spécifique. Il a les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|httpstepid|string|*(lecture seule)* ID de l'étape du scénario.|
|**name**<br>(obligatoire)|string|Nom de l'étape du scénario.|
|**no**<br>(obligatoire)|integer|Numéro de séquence de l'étape dans un scénario Web.|
|**url**<br>(obligatoire)|string|URL à vérifier.|
|follow\_redirects|integer|Suivre ou non les redirections HTTP.<br><br>Les valeurs possibles sont :<br>0 - ne pas suivre les redirections ;<br>1 - *(par défaut)* suivre les redirections.|
|headers|tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|En-têtes HTTP qui seront envoyés lors de l'exécution d'une requête. Les en-têtes d'étape de scénario remplaceront les en-têtes spécifiés pour le scénario Web.|
|httptestid|string|*(lecture seule)* ID du scénario Web auquel appartient l'étape.|
|posts|string<br>tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|Variables HTTP POST sous forme de chaîne (données de publication brutes) ou sous forme de tableau de [champs HTTP]( /manual/api/reference/httptest/object#HTTP field) (données du champ de formulaire).|
|required|string|Texte qui doit être présent dans la réponse.|
|retrieve\_mode|integer|Partie de la réponse HTTP que l'étape du scénario doit récupérer.<br><br>Les valeurs possibles sont :<br>0 - *(par défaut)* uniquement le corps ;<br>1 - uniquement les en-têtes ; <br>2 - en-têtes et corps.|
|status\_codes|string|Plages de codes d'état HTTP requis séparés par des virgules.|
|timeout|string|Délai d'expiration de la demande en secondes. Accepte les secondes, l'unité de temps avec suffixe et la macro utilisateur.<br><br>Par défaut : 15 s. Maximum : 1h. Minimum : 1s.|
|variables|tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|Variables d'étape de scénario.|
|query\_fields|tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field)|Champs de requête - tableau de [champs HTTP](/manual/api/reference/httptest/object#HTTP field) qui sera ajouté à l'URL lors de l'exécution d'une requête |

[comment]: # ({/bec454ad-eb20f47d})

[comment]: # ({05773163-d69e8b7b})
### Champ HTTP

L'objet de champ HTTP définit un nom et une valeur utilisés pour spécifier une variable, un en-tête HTTP, des données de champ de formulaire POST ou des données de champ de requête. Il a les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**name**<br>(obligatoire)|string|Nom de l'en-tête / variable / champ POST ou GET.|
|**value**<br>(obligatoire)|string|Valeur de l'en-tête / variable / champ POST ou GET..|

[comment]: # ({/05773163-d69e8b7b})