Saltar para o conteúdo principal
A API do Fire permite que seu sistema injete pedidos no Fire e gerencie operações relacionadas. Todos os endpoints são REST, aceitam e retornam JSON, e exigem autenticação via Bearer token.

Injetar pedido

Envie um pedido de qualquer agregador ou origem para o Fire processar.

​
URL base

https://api.fire.rest/v1
Todos os caminhos abaixo são relativos a esta URL base.

​
Autenticação

Cada requisição deve incluir sua API key como Bearer token: 
Authorization: Bearer <your_api_key>
Veja Autenticação para saber como obter e gerenciar API keys.

​
Formato de requisição e resposta

  • Todos os bodies de requisição devem ser JSON com Content-Type: application/json
  • Todas as respostas são JSON
  • Datas e timestamps usam formato ISO 8601 (2024-11-15T14:30:00Z)

​
Erros

O Fire usa códigos de status HTTP padrão. Todas as respostas de erro incluem um body JSON com um code legível por máquina e uma message legível por humanos. 
{
  "error": {
    "code": "validation_error",
    "message": "channel_id is required"
  }
}
StatusSignificado
200Sucesso
400Bad request — campos inválidos ou faltando no payload
401Não autorizado — API key faltando ou inválida
404Recurso não encontrado
409Conflito — external_order_id duplicado
429Limite de taxa excedido — aguarde e tente novamente
5xxErro do lado do Fire — tente novamente com backoff exponencial

​
Limites de taxa

As requisições têm limite de taxa por API key. Se você exceder o limite, o Fire retorna 429 Too Many Requests. Implemente backoff exponencial começando em 1 segundo.