Skip to main content
Utilisez des champs pour documenter les paramètres et les réponses d’API. Il existe deux types de champs : les champs de paramètres et les champs de réponses.

​
Champ de paramètre

Le composant <ParamField> sert à définir des paramètres pour vos API ou SDK. L’ajout d’un ParamField ajoute automatiquement un Terrain de jeu API.
​
string
requis
Un exemple de champ de paramètre

​
Propriétés

​
string
Indique si le paramètre est de type requête (query), chemin (path), corps (body) ou en-tête (header), suivi du nom du paramètre.
​
string
Type attendu pour la valeur du paramètre.Prend en charge number, string, boolean, object.Les tableaux peuvent être définis à l’aide du suffixe [], par exemple string[].
​
boolean
Indique si le paramètre est obligatoire.
​
boolean
Indique si le paramètre est obsolète.
​
any
Valeur par défaut utilisée lorsque la valeur fournie est vide.
​
string
Texte indicatif affiché dans le Terrain de jeu API.
​
string
Description du paramètre (Markdown activé).

​
Champ de réponse

Le composant <ResponseField> définit les valeurs de retour d’une API.
​
string
requis
Un exemple de champ de réponse

​
Propriétés

​
string
requis
Le nom de la valeur de réponse.
​
string
requis
Type attendu de la valeur de réponse. Il peut s’agir de n’importe quelle chaîne.
​
string
La valeur par défaut.
​
boolean
Indique si la réponse est requise.
​
boolean
Indique si un champ est obsolète.
​
string[]
Étiquettes affichées avant le nom du champ.
​
string[]
Étiquettes affichées après le nom du champ.