Básico

Overview

O Legis possui uma API REST para facilitar a integração com outras aplicações, permitindo o acesso a grande parte dos serviços da ferramenta.

Por requisições HTTP é possível criar solicitações, cadastrar e atualizar advogados, gerenciar tokens e tags, monitorar processos, realizar habilitações e protocolos, entre outras operações.

O contrato campo a campo — caminhos, parâmetros, corpos e respostas — está na documentação Swagger da API (Explorer e spec pública). Este texto cobre o fluxo geral da integração.

Há um ambiente de sandbox com a mesma API, isolado da produção, para validar criação, consulta e o tratamento do webhook sem acionar o tribunal. O caminho /simular só existe nesse ambiente.

Senhas de certificado e de credencial, e chaves TOTP, não vão em texto puro: a API espera uma string que começa com jusenc1.. O passo a passo está no Swagger dos endpoints de certificados e credenciais e no manual de criptografia.

Autenticação

A maior parte das requisições precisa ser autenticada.

O caminho mais comum na integração é o cabeçalho BearerStatic, com um token hexadecimal fornecido pela equipe Legis:

BearerStatic: <seu-token>

O token de sandbox é diferente do de produção. O token errado no ambiente errado resulta em erro de autenticação ou, pior, em ações reais.

A API também aceita:

• JWT do Legis — Authorization: Bearer <token>
• OIDC — Authorization: Bearer <token> e o cabeçalho X-Auth-Type: oidc

O Swagger lista os esquemas aceitos em cada operação.

Exemplo de requisição autenticada:

curl --request POST \
  --url https://api.jusapi.com/api/v2/legis/attachments/batch \
  --header 'BearerStatic: <seu-token>' \
  --header 'Content-Type: application/json'

Parâmetros de caminho