LBHM Tasks

Referência de API

O LBHM Tasks expõe uma API HTTP (JSON) para que outros sistemas criem e consultem tarefas automaticamente. O uso típico é enviar tarefas geradas por um sistema (uma pendência, uma exceção, uma solicitação) para que a equipe certa as receba e acompanhe.

Endereço base

Todas as rotas ficam sob o prefixo /api/v1 no endereço da sua organização:

https://suaorganizacao.tasks.lbhm.com.br/api/v1

O endereço exato é informado pela LBHM.

Autenticação

A API usa um token enviado no cabeçalho Authorization:

Authorization: Bearer SEU_TOKEN

Um administrador gera tokens na tela Tokens de acesso do sistema (cada token tem um nome e pode ser revogado a qualquer momento). O valor do token é exibido uma única vez, no momento da criação. Trate-o como um segredo: ele dá acesso à API da sua instância. Requisições sem token válido recebem 401 Unauthorized.

Formato

  • Corpo das requisições e respostas em JSON (Content-Type: application/json).
  • Datas em texto no formato AAAA-MM-DD HH:MM:SS (horário de Brasília) ou ISO 8601.
  • Códigos de resposta seguem o padrão HTTP: 200/201 em sucesso, 401 sem autenticação, 422 quando faltam campos obrigatórios, 404 quando o recurso não existe.

Valores de referência

  • Status de tarefa: aberta, em_andamento, bloqueada, concluida, cancelada.
  • Prioridade: baixa, media, alta, urgente.

Idempotência

Ao enviar tarefas, informe um par origem + external_ref (veja Tarefas). Reenviar a mesma combinação atualiza a tarefa existente em vez de criar uma duplicada — útil para reentregas e reprocessamentos seguros.

Próximas páginas