Usa campos para documentar parámetros y respuestas de la API. Hay dos tipos de campos: campos de parámetros y campos de respuesta.

​
Campo de parámetro

El componente <ParamField> se usa para definir parámetros de tus API o SDK. Al agregar un ParamField, se añade automáticamente un Área de pruebas de API.
​
param
string
required
Un ejemplo de campo de parámetro
<ParamField path="param" type="string" required>
  Un ejemplo de campo de parámetro
</ParamField>

​
Propiedades

​
query, path, body, or header
string
Indica si el parámetro es de consulta (query), ruta (path), cuerpo (body) o encabezado (header). A continuación, el nombre del parámetro.
​
type
string
Tipo esperado del valor del parámetro.Admite number, string, boolean, object.Los arrays se pueden definir con el sufijo []. Por ejemplo, string[].
​
required
boolean
Indica si el parámetro es obligatorio.
​
deprecated
boolean
Indica si el parámetro está obsoleto.
​
default
any
Valor predeterminado que se usa cuando el valor de la solicitud está vacío.
​
placeholder
string
Texto del placeholder para el campo en el área de pruebas.
​
children
string
Descripción del parámetro (compatible con Markdown).

​
Campo de respuesta

El componente <ResponseField> define los valores de retorno de una API.
​
response
string
required
Un ejemplo de un campo de respuesta
<ResponseField name="response" type="string" required>
  Un ejemplo de un campo de respuesta
</ResponseField>

​
Propiedades

​
name
string
required
El nombre del valor de la respuesta.
​
type
string
required
Tipo esperado del valor de la respuesta. Puede ser cualquier cadena de texto.
​
default
string
El valor predeterminado.
​
required
boolean
Indica si la respuesta es obligatoria.
​
deprecated
boolean
Indica si un campo está en desuso.
​
pre
string[]
Etiquetas que se muestran antes del nombre del campo.
​
post
string[]
Etiquetas que se muestran después del nombre del campo.