mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
fbdd913d8e
* Add translation tracker for stale translations audit Generated-By: mintlify-agent * translations: add missing pages and update content for es, fr, zh Phase 1: Add translations for 4 new API analytics pages (feedback-by-page, searches, views, visitors) in es, fr, and zh. Phase 2: Update 3 pages with content changes: - agent/workflows: add "Disable a workflow" subsection - ai/skillmd: add 24-hour generation note - editor/publish: add AI PR title tip, reformat publishing workflows, promote "Publish your changes" heading from h3 to h2 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * update descriptions * translations * translations * translations * Delete TRANSLATION_TRACKER.md * translations * a * a * translations * translations * translations * translations * translations * translations * translations * translations * Update use-cases.mdx * translations * translations * Update ai-native.mdx * Update accordions.mdx * Update accordions.mdx * Update accordions.mdx * translations * translations * Update fonts.mdx * translations * translations: update SEO descriptions for es, fr, zh (150 pages) Update the description: frontmatter field across 150 pages × 3 languages to match the current English descriptions updated on 2026-03-31. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
108 lines
3.1 KiB
Plaintext
108 lines
3.1 KiB
Plaintext
---
|
|
title: "Campos"
|
|
description: "Documenta los parámetros de solicitud y respuesta de la API con tipos, valores predeterminados y requisitos de validación."
|
|
keywords: ["ParamField", "ResponseField", "request parameters", "response documentation"]
|
|
---
|
|
|
|
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.
|
|
|
|
<div id="parameter-field">
|
|
## Campo de parámetro
|
|
</div>
|
|
|
|
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](/es/api-playground/overview).
|
|
|
|
<ParamField path="param" type="string" required>
|
|
Un ejemplo de campo de parámetro
|
|
</ParamField>
|
|
|
|
```mdx
|
|
<ParamField path="param" type="string" required>
|
|
Un ejemplo de un campo de parámetro
|
|
</ParamField>
|
|
```
|
|
|
|
<div id="properties">
|
|
### Propiedades
|
|
</div>
|
|
|
|
<ParamField body="query, path, body, or header" type="string">
|
|
Indica si el parámetro es de query, ruta, cuerpo o encabezado. Seguido del
|
|
nombre del parámetro.
|
|
</ParamField>
|
|
|
|
<ParamField body="type" type="string">
|
|
Tipo esperado del valor del parámetro.
|
|
|
|
Admite `number`, `string`, `boolean`, `object`.
|
|
|
|
Los arreglos se pueden definir con el sufijo `[]`. Por ejemplo, `string[]`.
|
|
</ParamField>
|
|
|
|
<ParamField body="required" type="boolean">
|
|
Indica si el parámetro es obligatorio.
|
|
</ParamField>
|
|
|
|
<ParamField body="deprecated" type="boolean">
|
|
Indica si el parámetro está en desuso.
|
|
</ParamField>
|
|
|
|
<ParamField body="default" type="any">
|
|
Valor predeterminado que se aplica cuando el valor de la solicitud está vacío.
|
|
</ParamField>
|
|
|
|
<ParamField body="placeholder" type="string">
|
|
Texto del marcador de posición para la entrada en el entorno de pruebas.
|
|
</ParamField>
|
|
|
|
<ParamField body="children" type="string">
|
|
Descripción del parámetro (compatible con Markdown).
|
|
</ParamField>
|
|
|
|
<div id="response-field">
|
|
## Campo de respuesta
|
|
</div>
|
|
|
|
El componente `<ResponseField>` define los valores de retorno de una API.
|
|
|
|
<ResponseField name="response" type="string" required>
|
|
Un ejemplo de un campo de respuesta
|
|
</ResponseField>
|
|
|
|
```mdx
|
|
<ResponseField name="response" type="string" required>
|
|
Un ejemplo de campo de respuesta
|
|
</ResponseField>
|
|
```
|
|
|
|
<div id="properties">
|
|
### Propiedades
|
|
</div>
|
|
|
|
<ResponseField name="name" type="string" required>
|
|
El nombre del valor de la respuesta.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="type" type="string" required>
|
|
Tipo esperado del valor de la respuesta. Puede ser cualquier cadena arbitraria.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="default" type="string">
|
|
Valor predeterminado.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="required" type="boolean">
|
|
Indica si la respuesta es obligatoria.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="deprecated" type="boolean">
|
|
Indica si un campo está en desuso.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="pre" type="string[]">
|
|
Etiquetas que se muestran antes del nombre del campo.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="post" type="string[]">
|
|
Etiquetas que se muestran después del nombre del campo.
|
|
</ResponseField> |