DirectLuzDirectLuzDocs
Ordens de Serviço

Response Codes

Códigos HTTP retornados pela DirectLuz e códigos esperados do parceiro.

Inbound — resposta da DirectLuz ao sistema externo

CódigoSignificado
200Operação idempotente — resultado original retornado
201Recurso criado com sucesso
400Requisição malformada
401Autenticação inválida
403Escopo insuficiente
409Conflito — recurso já existe em estado incompatível
422Falha de validação de campo (inclui assetType ausente ou desconhecido)
429Limite de taxa excedido
500Erro interno
503Serviço temporariamente indisponível
504Tempo de processamento excedido

Em casos 422, a resposta inclui o corpo:

{
  "errors": [
    { "field": "assetType", "message": "Valor de assetType desconhecido." }
  ]
}

Outbound — resposta esperada do sistema externo à DirectLuz (modo Webhook)

CódigoInterpretação pela DirectLuz
2xxEntrega confirmada
408Falha transitória — agenda reentrega
429Falha transitória — agenda reentrega respeitando Retry-After se presente
4xx (exceto 408, 429)Falha permanente — evento descartado
5xxFalha transitória — agenda reentrega

Polling

Modo de transporte alternativo ao Webhook — consulta e envio em janelas de até 3 minutos.

Postes, telegestores e ordens de serviço

Leitura em lote de postes, telegestores e ordens de serviço do tenant, com pull incremental por cursor de data.

On this page

Inbound — resposta da DirectLuz ao sistema externoOutbound — resposta esperada do sistema externo à DirectLuz (modo Webhook)