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

​
Campo de parámetro

El componente <ParamField> se utiliza 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
required
Un ejemplo de un 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 tipo 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.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á en desuso.
​
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 el campo en el playground.
​
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
Ejemplo de un campo de respuesta
<ResponseField name="response" type="string" required>
  Un ejemplo de 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 arbitraria.
​
default
string
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.
⌘I