Saltar al contenido principal
Usa campos para documentar los parámetros y las respuestas de la API. Hay dos tipos de campos: campos de parámetro y campos de respuesta.

​
Campo de parámetro

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

​
Propiedades

​
query, path, body, or header
string
Indica si el parámetro es de query, ruta, cuerpo o encabezado. Seguido del nombre del parámetro.
​
type
string
Tipo esperado del valor del parámetro.Admite number, string, boolean, object.Define los arreglos con el sufijo []. Por ejemplo, string[].
​
required
boolean
Indica si requieres el parámetro.
​
deprecated
boolean
Indica si has marcado el parámetro como obsoleto.
​
default
any
Valor predeterminado que se aplica cuando el valor de la solicitud está vacío.
​
placeholder
string
Texto del marcador de posición para la entrada en el entorno 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
requerido
Un ejemplo de un campo de respuesta
<ResponseField name="response" type="string" required>
  Un ejemplo de campo de respuesta
</ResponseField>

​
Propiedades

​
name
string
requerido
El nombre del valor de la respuesta.
​
type
string
requerido
Tipo esperado del valor de la respuesta. Puede ser cualquier cadena arbitraria.
​
default
string
Valor predeterminado.
​
required
boolean
Indica si requieres la respuesta.
​
deprecated
boolean
Indica si has marcado un campo como obsoleto.
​
pre
string[]
Etiquetas que aparecen antes del nombre del campo.
​
post
string[]
Etiquetas que aparecen después del nombre del campo.