# Introducción
URL: https://docs.fluenta.io/docs

Qué te da la API, con qué credencial se usa y por dónde empezar.



La API de Fluenta te da por HTTP lo que ves en el panel: la planta, el
Programa, los tableros y los reportes de las organizaciones a las que
perteneces, con las mismas cifras. Sirve para tus propios programas y para
aplicaciones de IA.

Todas las rutas cuelgan de una sola URL base:

```
https://api.fluenta.io/v1/external
```

## Lo que conviene saber antes de empezar [#lo-que-conviene-saber-antes-de-empezar]

* **Dos credenciales.** Un token de API, que creas en «Configuración» →
  «Tokens de API» y funciona en los planes Light y Pro, o una conexión, que es una
  aplicación de IA autorizada con «Conectar con IA» y pide Pro. Las dos viajan
  en el encabezado `Authorization`. Sigue en [Autenticación](./authentication.mdx).
* **Actúas como tú.** Cada llamada usa el rol que tienes en el panel, leído de
  nuevo en cada solicitud, y nombra la organización en la ruta. Sigue en
  [Organizaciones](./organizations.mdx).
* **El plan decide.** La API le da a cada organización lo que su plan le da en
  el panel. Sigue en [Planes](./plans.mdx).
* **Permisos.** `read` («Leer») viene siempre. `program` («Gestionar el
  Programa») hace falta para escribir en el Programa y en el catálogo de
  referencias. Sigue en [Permisos](./permissions.mdx).
* **Errores.** Toda respuesta de error tiene la forma
  `{ statusCode, code, message }`. Decide por `code`. Sigue en
  [Errores](./errors.mdx).

## Por dónde empezar [#por-dónde-empezar]

<Cards>
  <Card title="Inicio rápido" href="/docs/quickstart">
    Crea un token de API y haz tu primera solicitud.
  </Card>

  <Card title="Referencia" href="/docs/reference">
    Una página por operación, generada desde el documento OpenAPI.
  </Card>

  <Card title="Usar la API con una IA" href="/docs/ai">
    El índice en llms.txt, cada página en Markdown y el documento OpenAPI.
  </Card>
</Cards>

El documento OpenAPI completo está en [`/openapi.json`](/openapi.json), y el
índice para agentes en [`/llms.txt`](/llms.txt).
