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

# Descripción general de la API

> Endpoints, formato de solicitud y cómo leer las respuestas de la API GraphQL de Fluz.

La API de Fluz es un único endpoint de GraphQL por entorno. Esta página es la referencia complementaria de [Cómo funciona la API GraphQL](/concepts/graphql).

## Explorar la referencia

<CardGroup cols={2}>
  <Card title="Consultas" icon="search" href="/api-reference/queries/approval-requests">
    Operaciones de lectura: obtener billeteras, transacciones, comercios, ofertas de tarjetas y datos de cuenta.
  </Card>

  <Card title="Mutaciones" icon="square-pen" href="/api-reference/mutations/add-authorized-user">
    Operaciones de escritura: emitir tarjetas, mover dinero, registrar usuarios y negocios, y administrar aprobaciones.
  </Card>
</CardGroup>

### Tipos

<CardGroup cols={3}>
  <Card title="Objetos" icon="box" href="/api-reference/types/account">
    Estructuras de respuesta devueltas por consultas y mutaciones.
  </Card>

  <Card title="Objetos de entrada" icon="text-cursor-input" href="/api-reference/types/add-bank-card-input">
    Argumentos que pasas a las operaciones.
  </Card>

  <Card title="Enums" icon="list-ordered" href="/api-reference/types/account-type">
    Conjuntos fijos de valores permitidos, como estados y redes de tarjetas.
  </Card>

  <Card title="Uniones" icon="combine" href="/api-reference/types/stock-info-type">
    Campos que se resuelven en uno de varios tipos de objeto.
  </Card>

  <Card title="Interfaces" icon="plug" href="/api-reference/types/basic-user-cash-balance">
    Contratos de campos compartidos implementados por múltiples objetos.
  </Card>

  <Card title="Escalares" icon="hash" href="/api-reference/types/date-time">
    Valores primitivos como DateTime y UUID.
  </Card>
</CardGroup>

### Convenciones

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/api-reference/authentication">
    El encabezado Authorization, endpoints de tokens y la redirección de autorización de OAuth.
  </Card>

  <Card title="Errores" icon="triangle-alert" href="/api-reference/errors">
    El sobre de error, prefijos de códigos de dominio y guía de reintentos.
  </Card>

  <Card title="Límites de velocidad" icon="gauge" href="/api-reference/rate-limits">
    Límites de solicitudes por superficie y cómo se ve un 429.
  </Card>

  <Card title="Paginación" icon="chevrons-right" href="/api-reference/pagination">
    Entradas de desplazamiento, límites de tamaño de página y respuestas de conexión.
  </Card>
</CardGroup>

<Card title="Endpoints REST" icon="route" horizontal href="/api-reference/rest/upload-sole-proprietorship-document">
  Una operación vive fuera de GraphQL: la carga de archivos utilizada para el registro de empresa unipersonal.
</Card>

## Endpoints

| Entorno | Endpoint de GraphQL                                              |
| ------- | ---------------------------------------------------------------- |
| Staging | `https://transactional-graph.staging.fluzapp.com/api/v1/graphql` |
| Live    | `https://transactional-graph.fluzapp.com/api/v1/graphql`         |

Los tokens de acceso se generan en el mismo endpoint mediante la mutación `generateUserAccessToken`, autorizada con tu API Key. Consulta [Autenticación](/api-reference/authentication).

## Encabezados

| Encabezado      | Requerido | Notas                                                                                 |
| --------------- | --------- | ------------------------------------------------------------------------------------- |
| `Authorization` | Sí        | `Bearer <access_token>` (`Basic <API_KEY>` cuando llamas a `generateUserAccessToken`) |
| `Content-Type`  | Sí        | `application/json`                                                                    |

## Sobre de respuesta

```json theme={null}
{
  "data": { ... },
  "errors": [ ... ]
}
```

* `data`: la carga útil exitosa (puede ser parcial en caso de error).
* `errors`: arreglo de fallas, cada una con `code`, `message` y `path`.

## Esquema

Staging expone introspección para que puedas apuntar tus herramientas (Apollo Studio, GraphiQL, codegen) directamente. En live, solicita el SDL actual a tu equipo de cuenta.