Saltar al contenido principal
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"
  }
}
EstadoSignificado
200Éxito
400Bad request — campos inválidos o faltantes en el payload
401No autorizado — API key faltante o inválida
404Recurso no encontrado
409Conflicto — external_order_id duplicado
429Límite de tasa excedido — espera y reintenta
5xxError 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.