Referência da API

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"
  }
}

Status	Significado
`200`	Sucesso
`400`	Bad request — campos inválidos ou faltando no payload
`401`	Não autorizado — API key faltando ou inválida
`404`	Recurso não encontrado
`409`	Conflito — `external_order_id` duplicado
`429`	Limite de taxa excedido — aguarde e tente novamente
`5xx`	Erro 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.

API

APIs de parceiro

PayBridge

Referência da API

Injetar pedido

URL base

Autenticação

Formato de requisição e resposta

Erros

Limites de taxa

Injetar pedido

​URL base

​Autenticação

​Formato de requisição e resposta

​Erros

​Limites de taxa

URL base

Autenticação

Formato de requisição e resposta

Erros

Limites de taxa