Cofre de Credenciais
Acesse os Tribunais com Suas Próprias Credenciais
A JUDIT permite adicionar as credenciais dos advogados de sua preferência, possibilitando o acesso, por meio dessas credenciais, a processos em segredo de justiça de autoria dos respectivos advogados.
Rota para cadastrar suas chaves no cofre de credenciais
Para começar a utilizar o cofre de credeniais, você deve realizar uma solicitação POST para a rota crawler.prod.judit.io/credentials
e cadastrar as credenciais dos advogados nos respectivos tribunais disponibilizados.
Payload da Solicitação
A solicitação POST deve incluir um payload com as seguintes propriedades:
-
system_name
: A sigla do tribunal e sistema que será cadastrado a nova credencial.Obs:
Poderá ser cadastrada uma credencial coringa"system_name": "*"
. Se uma credencial for cadastrada nela, todos os tribunais que não tiverem outra credencial cadastrada utilizarão a credencial coringa.
-
customer_key
: Identificador personalizado para associar a credencial a um cliente ou advogado. Pode ser qualquer nome ou rótulo definido pelo responsável pelo cadastro, facilitando a organização e o gerenciamento das credenciais. -
username
: CPF (Cadastro de Pessoas Físicas) ou número da OAB (Ordem dos Advogados do Brasil), conforme exigido pelo sistema do tribunal onde o login será realizado. -
password
: Senha cadastrada no respectivo tribunal.
Propriedades necessárias apenas nos casos de tribunais que exigem autenticação de dois fatores:
-
custom_data
: Objeto opcional destinado a armazenar informações adicionais específicas para o sistema ou contexto de uso. Pode incluir campos personalizados como, por exemplo, um secret necessário para autenticação ou outras configurações específicas. -
secret
: Token de autenticação de dois fatores do sistema a ser cadastrado.
Obs:
As credenciais cadastradas são criptografadas, garantindo a segurança dos dados, e não podem ser acessadas posteriormente. Para modificar informações já cadastradas, basta criar um novo registro utilizando o mesmo customer_key
e o mesmo system_name
. O novo cadastro substituirá automaticamente a credencial existente.
Exemplo de payload para cadastro de credenciais sem autenticação de dois fatores:
Exemplo de payload para cadastro de credenciais com autenticação de dois fatores:
Exemplo de resposta a solicitação:
Rota de verificação de credenciais cadastradas
Para verificar se uma credencial está cadastrada, envie uma solicitação GET para o endpoint crawler.prod.judit.io/credentials
, incluindo o parâmetro customer_key
correspondente à credencial que deseja consultar.
A resposta retornará todas as credenciais disponíveis no cofre associadas à customer_key
consultada. O campo credential_status
indicará o status de cada credencial:
- active: Credencial cadastrada e ativa.
- not exists: Credencial não encontrada no sistema.
Segue um exemplo de solicitação GET para verificar a existência de uma credencial:
Segue um exemplo de resposta para a solicitação GET realizada:
Rota para deletar uma chave no cofre de Credenciais
Para deletar um sistema no cofre de credenciais, você deve realizar uma solicitação DELETE para a rota crawler.prod.judit.io/credentials
.
Payload da Solicitação
A solicitação DELETE deve incluir um payload com a seguinte propriedade:
system_name
: A sigla do tribunal e sistema que será cadastrado a nova credencial.customer_key
: Identificador personalizado adicionado no momento do cadastro da credencial.
Exemplo de payload para deletar credencial:
- Caso a solicitação seja bem sucedida a resposta será um objeto vazio.
A atualização das credenciais nos tribunais é de inteira responsabilidade do usuário. Portanto, cabe ao usuário realizar o cadastro da credencial no tribunal correspondente e acompanhar a validade e a situação da mesma para garantir que ela não seja suspensa ou invalidada.