Recuperação de eventos de webhook (v2)

Consulte o histórico das entregas de webhook feitas pela Cobli para a sua frota, incluindo o payload byte-idêntico ao que sua aplicação recebeu via push e os metadados da entrega (URL, status HTTP, retentativas, timestamp).

Use este endpoint para:

  • Reconciliar entregas após indisponibilidade da sua aplicação;
  • Auditar falhas de entrega (filtrar por statusCode);
  • Deduplicar contra eventos já processados — o event_id retornado
    é o mesmo que sua aplicação recebeu (ou teria recebido) via push.

Diferenças vs /public/v1/events:

  • Resposta em formato envelope { delivery, payload, format, event_id, event_time, event_type } — separa metadados de entrega do payload
    em si.

  • O campo payload é objeto JSON nativo (não string com JSON
    encadeado).

  • O payload respeita o formato em que sua aplicação recebeu o evento
    no push
    — frotas em formato canônico recebem camelCase
    ("format": "v1"); frotas legadas recebem snake_case
    ("format": "alexstrasza-v1").

  • Janela máxima enforced: 15 dias. Pedidos com `endDate - startDate

    15 diasretornam400. Pedidos com endDatemais antigo que 15 dias retornam410 Gone`.

  • Limite máximo de página: 200. Default 20.

A resposta é paginada via pageState/next_page_state — chame novamente passando em pageState o valor recebido em next_page_state até que ele venha ausente ou null.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date-time
required

Início da janela de busca, em ISO 8601 com timezone (UTC recomendado). A janela é inclusiva no início.

date-time
required

Fim da janela de busca, em ISO 8601 com timezone (UTC recomendado). Deve estar dentro dos últimos 15 dias.

string

Filtra apenas eventos do tipo informado. Exemplos: position, ignition_on, geofence_in. Quando omitido, retorna todos os tipos registrados.

integer

Filtra entregas pelo código de status retornado. Inclui sentinelas não-HTTP: -1 (timeout/DNS/conexão recusada), -3 (circuit-breaker aberto após 5+ falhas), 0 (erro não-classificado).

integer
1 to 200
Defaults to 20

Número máximo de eventos por página. Range 1..200. Default 20.

string

Token opaco devolvido em next_page_state na requisição anterior. Omita na primeira chamada.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json