# Configuración de la API (/es/organize/settings-api)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 2363 · updated: 2026-07-30 -->
Related: [Configuración global](/es/organize/settings.md), [Apariencia y marca](/es/organize/settings-appearance.md), [Estructura del sitio](/es/organize/settings-structure.md), [Integraciones](/es/organize/settings-integrations.md), [SEO y búsqueda](/es/organize/settings-seo.md), [Referencia del esquema docs.json](/es/organize/settings-reference.md)

Usa el campo `api` en `docs.json` para configurar qué especificaciones de API generan páginas de API, el área de pruebas interactiva de la API para probar endpoints, y cómo generar y mostrar ejemplos de código.

## Ajustes [#ajustes]

### `api` [#api]

**Tipo:** `object`

Define todos los ajustes relacionados con la API bajo la clave `api`.

<ResponseField name="api.openapi" type="string or array or object">
  Archivos de especificación OpenAPI para generar páginas de referencia de API. Acepta una única ruta o URL, un array de rutas y URLs, o un objeto que especifica una fuente y directorio.

  <Expandable title="api.openapi object">
    <ResponseField name="source" type="string">
      URL o ruta a tu archivo de especificación OpenAPI. Longitud mínima: 1.
    </ResponseField>

    <ResponseField name="directory" type="string">
      Directorio donde buscar archivos OpenAPI. No incluyas una barra inicial.
    </ResponseField>
  </Expandable>

  <CodeGroup>
    <CodeBlockTabs defaultValue="Archivo único" groupId="archivo-nico+directorio+m-ltiples-archivos">
      <CodeBlockTabsList>
        <CodeBlockTabsTrigger value="Archivo único">
          Archivo único
        </CodeBlockTabsTrigger>

        <CodeBlockTabsTrigger value="Múltiples archivos">
          Múltiples archivos
        </CodeBlockTabsTrigger>

        <CodeBlockTabsTrigger value="Directorio">
          Directorio
        </CodeBlockTabsTrigger>
      </CodeBlockTabsList>

      <CodeBlockTab value="Archivo único">
        ```json  
        "openapi": "openapi.json"
        ```
      </CodeBlockTab>

      <CodeBlockTab value="Múltiples archivos">
        ```json  
        "openapi": [
          "openapi/v1.json",
          "openapi/v2.json",
          "https://api.example.com/openapi.yaml"
        ]
        ```
      </CodeBlockTab>

      <CodeBlockTab value="Directorio">
        ```json  
        "openapi": {
          "source": "openapi.json",
          "directory": "api-reference"
        }
        ```
      </CodeBlockTab>
    </CodeBlockTabs>
  </CodeGroup>
</ResponseField>

<ResponseField name="api.asyncapi" type="string or array or object">
  Archivos de especificación AsyncAPI para generar páginas de referencia de API basadas en eventos. Acepta una única ruta o URL, un array de rutas y URLs, o un objeto que especifica una fuente y directorio.

  <Expandable title="api.asyncapi object">
    <ResponseField name="source" type="string">
      URL o ruta a tu archivo de especificación AsyncAPI. Longitud mínima: 1.
    </ResponseField>

    <ResponseField name="directory" type="string">
      Directorio donde buscar archivos AsyncAPI. No incluyas una barra inicial.
    </ResponseField>
  </Expandable>

  <CodeGroup>
    <CodeBlockTabs defaultValue="Archivo único" groupId="archivo-nico+directorio+m-ltiples-archivos">
      <CodeBlockTabsList>
        <CodeBlockTabsTrigger value="Archivo único">
          Archivo único
        </CodeBlockTabsTrigger>

        <CodeBlockTabsTrigger value="Múltiples archivos">
          Múltiples archivos
        </CodeBlockTabsTrigger>

        <CodeBlockTabsTrigger value="Directorio">
          Directorio
        </CodeBlockTabsTrigger>
      </CodeBlockTabsList>

      <CodeBlockTab value="Archivo único">
        ```json  
        "asyncapi": "asyncapi.json"
        ```
      </CodeBlockTab>

      <CodeBlockTab value="Múltiples archivos">
        ```json  
        "asyncapi": [
          "asyncapi/events.yaml",
          "asyncapi/webhooks.yaml"
        ]
        ```
      </CodeBlockTab>

      <CodeBlockTab value="Directorio">
        ```json  
        "asyncapi": {
          "source": "asyncapi.json",
          "directory": "websockets"
        }
        ```
      </CodeBlockTab>
    </CodeBlockTabs>
  </CodeGroup>
</ResponseField>

<ResponseField name="api.playground" type="object">
  Configuración del área de pruebas interactiva de la API.

  <Expandable title="api.playground">
    <ResponseField name="display" type="&#x22;interactive&#x22; | &#x22;simple&#x22; | &#x22;none&#x22; | &#x22;auth&#x22;">
      El modo de visualización del área de pruebas. El valor predeterminado es `interactive`.

      * `interactive` — Área de pruebas interactiva completa con constructor de solicitudes
      * `simple` — Vista simplificada sin el constructor de solicitudes
      * `none` — Ocultar el área de pruebas por completo
      * `auth` — Mostrar el área de pruebas solo a usuarios autenticados
    </ResponseField>

    <ResponseField name="proxy" type="boolean">
      Si se deben enrutar las solicitudes de API a través de un servidor proxy. El valor predeterminado es `true`.
    </ResponseField>

    <ResponseField name="credentials" type="boolean">
      Indica si se deben incluir cookies y encabezados de autenticación en las solicitudes cross-origin cuando `proxy` es `false`. El valor predeterminado es `false`. No tiene efecto cuando `proxy` es `true`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="api.params" type="object">
  Configuración de visualización para los parámetros de la API.

  <Expandable title="api.params">
    <ResponseField name="expanded" type="&#x22;all&#x22; | &#x22;closed&#x22;">
      Si se expanden todos los parámetros de forma predeterminada. El valor predeterminado es `closed`.
    </ResponseField>

    <ResponseField name="post" type="array of string">
      Claves de campos de la especificación OpenAPI que se mostrarán como píldoras post junto al nombre de cada parámetro en las páginas de referencia de la API y en el playground. Para cada clave que enumeres, Mintlify lee el valor del esquema y lo renderiza como una píldora:

      * Los valores de cadena se renderizan como la cadena literal.
      * `true` renderiza el nombre de la clave como etiqueta de la píldora. `false`, `null` y las cadenas vacías no renderizan nada.
      * Los valores numéricos renderizan el número convertido a cadena.
      * Los arreglos de cadenas o números renderizan una píldora por elemento.
      * Los objetos y otros valores se omiten.

      Usa esto para exponer campos personalizados de OpenAPI —como `x-internal`, `nullable` o extensiones de proveedor— como anotaciones visuales en cada parámetro sin necesidad de configuración por propiedad.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="api.url" type="&#x22;full&#x22;">
  Modo de visualización de la URL base en el encabezado del endpoint. Establece `full` para mostrar siempre la URL base completa en cada página de endpoint. Por defecto, la URL base solo se muestra cuando hay múltiples URLs base para seleccionar.
</ResponseField>

<ResponseField name="api.examples" type="object">
  Configuración para los ejemplos de código de API generados automáticamente.

  <Expandable title="api.examples">
    <ResponseField name="languages" type="array of string">
      Lenguajes para los fragmentos de código generados automáticamente. Consulta [lenguajes compatibles](/es/api-playground/overview#all-supported-languages) para ver la lista completa de lenguajes y alias disponibles.
    </ResponseField>

    <ResponseField name="defaults" type="&#x22;required&#x22; | &#x22;all&#x22;">
      Si se incluyen parámetros opcionales en los ejemplos generados. El valor predeterminado es `all`.
    </ResponseField>

    <ResponseField name="prefill" type="boolean">
      Si se precarga el área de pruebas con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`.
    </ResponseField>

    <ResponseField name="autogenerate" type="boolean">
      Si se generan muestras de código para endpoints a partir de tu especificación de API. El valor predeterminado es `true`. Cuando se establece en `false`, solo aparecen en el área de pruebas las muestras de código escritas manualmente (desde `x-codeSamples` en OpenAPI o componentes `<RequestExample>` en MDX).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="api.mdx" type="object">
  Configuración para páginas de API creadas a partir de archivos MDX en lugar de especificaciones OpenAPI.

  <Expandable title="api.mdx">
    <ResponseField name="auth" type="object">
      Configuración de autenticación para solicitudes de API basadas en MDX.

      <Expandable title="auth">
        <ResponseField name="method" type="&#x22;bearer&#x22; | &#x22;basic&#x22; | &#x22;key&#x22; | &#x22;cobo&#x22;">
          Método de autenticación para las solicitudes de API.
        </ResponseField>

        <ResponseField name="name" type="string">
          Nombre del parámetro de autenticación para las solicitudes de API.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="server" type="string or array">
      URL base que se antepone a las rutas relativas en los campos de frontmatter `api` a nivel de página. No se utiliza cuando el frontmatter contiene una URL completa.
    </ResponseField>
  </Expandable>
</ResponseField>

## Ejemplo [#ejemplo]

```json title="docs.json"
{
  "api": {
    "openapi": ["openapi/v1.json", "openapi/v2.json"],
    "playground": {
      "display": "interactive"
    },
    "params": {
      "expanded": "all",
      "post": ["nullable", "x-internal"]
    },
    "url": "full",
    "examples": {
      "languages": ["curl", "python", "javascript", "go"],
      "defaults": "required",
      "prefill": true,
      "autogenerate": true
    }
  }
}
```