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:


{
  "credentials": [
    {
      "system_name": "PJE TJBA - 1º grau",
      "customer_key": "00000001",
      "username": "999.999.999-99",
      "password": "Senha123"
    },
    {
      "system_name": "ESAJ - TJAC - 1º grau",
      "customer_key": "00000002",
      "username": "999.999.999-99",
      "password": "Senha123"
    }
  ]
}

Exemplo de payload para cadastro de credenciais com autenticação de dois fatores:


{
  "credentials": [
    {
      "system_name": "PJE TJBA - 1º grau",
      "customer_key": "00000001",
      "username": "999.999.999-99",
      "password": "Senha123",
      "custom_data": {
				"secret": "<TOKEN>"
			}
    }
  ]
}

Exemplo de resposta a solicitação:


[
    {
        "system_name": "ESAJ - TJAC - 1º grau",
        "message": "CREDENTIAL_CREATED"
    },
    {
        "system_name": "PJE TJBA - 1º grau",
        "message": "CREDENTIAL_CREATED"
    }
]

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:


curl --location 'https://crawler.prod.judit.io/credentials?customer_key=teste_01' \
--header 'api-key: <API-KEY>'

Segue um exemplo de resposta para a solicitação GET realizada:


{
    "systems": [
        {
            "name": "*",
            "customer_key": "",
            "credential_status": "not exists"
        },
        {
            "name": "ESAJ - TJAM - 1º grau",
            "customer_key": "teste_01",
            "credential_status": "active"
        },
        {
            "name": "PROJUDI TJGO - 1º grau",
            "customer_key": "teste_01",
            "credential_status": "active"
        }
    ]
}

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:


{
	"system_name": "PROJUDI TJGO - 1º grau",
    "customer_key":"teste_01"
}

  • 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.