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

# Referencia API

> Referencia REST de la API de Fire — inyecta órdenes y consulta la configuración de tu integración.

La API de Fire permite que tu sistema inyecte órdenes en Fire y gestione operaciones relacionadas. Todos los endpoints son REST, aceptan y devuelven JSON, y requieren autenticación vía Bearer token.

<CardGroup cols={2}>
  <Card title="Inyectar orden" icon="paper-plane" href="/es/api-reference/orders">
    Envía una orden desde cualquier agregador u origen hacia Fire para su procesamiento.
  </Card>
</CardGroup>

## URL base

```
https://api.fire.rest/v1
```

Todas las rutas a continuación son relativas a esta URL base.

## Autenticación

Cada petición debe incluir tu API key como Bearer token:

```http theme={null}
Authorization: Bearer <your_api_key>
```

Consulta [Autenticación](/es/authentication) para saber cómo obtener y gestionar API keys.

## Formato de petición y respuesta

* Todos los bodies de petición deben ser JSON con `Content-Type: application/json`
* Todas las respuestas son JSON
* Las fechas y timestamps usan formato ISO 8601 (`2024-11-15T14:30:00Z`)

## Errores

Fire usa códigos de estado HTTP estándar. Todas las respuestas de error incluyen un body JSON con un `code` legible por máquina y un `message` legible por humanos.

```json theme={null}
{
  "error": {
    "code": "validation_error",
    "message": "channel_id is required"
  }
}
```

| Estado | Significado                                                |
| ------ | ---------------------------------------------------------- |
| `200`  | Éxito                                                      |
| `400`  | Bad request — campos inválidos o faltantes en el payload   |
| `401`  | No autorizado — API key faltante o inválida                |
| `404`  | Recurso no encontrado                                      |
| `409`  | Conflicto — `external_order_id` duplicado                  |
| `429`  | Límite de tasa excedido — espera y reintenta               |
| `5xx`  | Error del lado de Fire — reintenta con backoff exponencial |

## Límites de tasa

Las peticiones tienen límite de tasa por API key. Si excedes el límite, Fire devuelve `429 Too Many Requests`. Implementa backoff exponencial empezando en 1 segundo.