> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Ejecuta las cuatro APIs de demo localmente y pruébalas desde el playground de API de este sitio.

Puedes leer todo este sitio sin ejecutar nada. Para usar el playground **Try it**, ejecuta una API en tu computadora.

cambio

marco haciendo cambios

nueva línea. prueba.

**1. Comprueba lo que necesitas**

Necesitas Python 3.10 o posterior y `git`.

> [tab] macOS
>
> ```bash theme={null}
> brew install python git
> ```

> [tab] Linux
>
> ```bash theme={null}
> sudo apt install python3 python3-venv git
> ```

> [tab] Windows
>
> ```powershell theme={null}
> winget install Python.Python.3.12 Git.Git
> ```

**2. Elige una API e iníciala**

```bash Merge Sort API theme={null}
git clone https://github.com/mintlify-demo/merge-sort-api.git
cd merge-sort-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Calculator API theme={null}
git clone https://github.com/mintlify-demo/calculator-api.git
cd calculator-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Todo API theme={null}
git clone https://github.com/mintlify-demo/todo-api.git
cd todo-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Text Utils API theme={null}
git clone https://github.com/mintlify-demo/text-utils-api.git
cd text-utils-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

> [!WARNING]
>
> Todas las APIs usan el puerto `8000`. Ejecuta una a la vez, o inicia las demás con `--port 8001`.

**3. Abre su referencia de API**

Elige la pestaña correspondiente en la parte superior de este sitio, selecciona un endpoint y haz clic en **Try it**. El playground envía la solicitud desde tu navegador directamente a `http://localhost:8000`.

**4. Envía una solicitud**

Para la Todo API, introduce `demo-key` como clave de API. Las demás APIs no necesitan clave.

> [!TIP]
>
> Estás ejecutando una API real y llamándola desde documentación generada.

> [!TIP]
>
> ¿Vas a mostrar esto en vivo? Inicia la API antes de la llamada y mantén tu navegador en la página del endpoint. El playground, los ejemplos de código y el visor de respuestas se actualizan mientras escribes.

## Solución de problemas

> [accordion] El playground dice que no puede conectarse al servidor
>
> Asegúrate de que la API esté en ejecución y muestre `Uvicorn running on http://127.0.0.1:8000`. Las APIs permiten solicitudes de origen cruzado, así que no se necesita configuración adicional.

> [accordion] `pip install` falla
>
> Comprueba que activaste el entorno virtual: tu prompt debería comenzar con `(.venv)`.

> [accordion] El puerto 8000 ya está en uso
>
> Detén la otra API o ejecuta `uvicorn main:app --port 8001`.

## Cómo está construido este sitio

El código y las pruebas de cada API viven en el repositorio de esa API. Toda la documentación, incluidas las guías y la especificación OpenAPI de cada API, vive en el [repositorio de documentación](https://github.com/mintlify-demo/docs). Cuando cambia el código de una API, el agente de Mintlify abre una pull request en el repositorio de documentación con la actualización correspondiente.

```mermaid theme={null}
flowchart LR
    A[merge-sort-api] -- cambio de código --> M{{Agente de Mintlify}}
    B[calculator-api] -- cambio de código --> M
    C[todo-api] -- cambio de código --> M
    D[text-utils-api] -- cambio de código --> M
    M -- PR de documentación --> E[docs]
    E --> S[Un solo sitio de documentación]
```

> [card] [Componentes](https://docs.marcodewey.com/es/showcase/components.md)
>
> Cada pieza utilizada en este sitio.

> [card] [Funciones de IA](https://docs.marcodewey.com/es/showcase/ai.md)
>
> El asistente, llms.txt, el servidor MCP y más.
