Referencia API

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.

Inyectar orden

Envía una orden desde cualquier agregador u origen hacia Fire para su procesamiento.

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:

Authorization: Bearer <your_api_key>

Consulta Autenticación 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.

{
  "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.

API

APIs de partner

PayBridge

Inyectar orden

URL base

Autenticación

Formato de petición y respuesta

Errores

Límites de tasa

Inyectar orden

​URL base

​Autenticación

​Formato de petición y respuesta

​Errores

​Límites de tasa

URL base

Autenticación

Formato de petición y respuesta

Errores

Límites de tasa