Cofre de 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: A forma que o cliente será identificado.

• username: O CPF (Cadastro de Pessoas Físicas) ou o número da OAB (Ordem dos Advogados do Brasil), conforme o sistema do tribunal onde o usuário irá realizar o login.

• password: Senha cadastrada no respectivo tribunal.

Propriedades necessárias apenas nos casos de tribunais que exigem autenticação de dois fatores:

• custom_data: Campo obrigatório para adicionar elementos opcionais.

• secret: Token de autenticação de dois fatores do sistema a ser cadastrado.

Obs: As credenciais são criptografadas, não sendo possível acessar os dados cadastrados posteriormente. Caso seja necessário alterar algum dado cadastrado, basta sobrescrever a credencial com um novo cadastro.

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 Verificação de Credenciais Cadastradas

Para visualizar todas as credenciais atreladas ao seu usuário, você deve realizar uma solicitação GET para a rota crawler.prod.judit.io/credentials.

Será retornado todas as credenciais disponíveis no cofre de credenciais. O campo credential_status indicará o status de cada credencial, sendo active para credenciais cadastradas e not exists para credenciais não cadastradas.

Exemplo de resposta com alguns tribunais e sistemas:

{
  "systems": [
    {
      "name": "ESAJ - TJSP - 2º grau",
      "customer_key": "",
      "credential_status": "not exists"
    },
    {
      "name": "PJE INTER TJBA - 1º grau",
      "customer_key": "00000001",
      "credential_status": "active"
    },
    {
      "name": "PJE TJAP - 1º grau",
      "customer_key": "",
      "credential_status": "not exists"
    },
    {
      "name": "PJE TJAP - 2º grau",
      "customer_key": "",
      "credential_status": "not exists"
    },
    {
      "name": "PJE TJBA - 1º grau",
      "customer_key": "00000002",
      "credential_status": "active"
    },
    {
      "name": "PJE TJBA - 2º grau",
      "customer_key": "00000002",
      "credential_status": "active"
    },
    ...
  ]
}

Filtrando por credencial:

Para realizar um filtro consultando uma credencial especifica cadastrada basta adicionar ?customer_key=<Valor cadastrado> ao endpoint.

Exemplo de endpoint com filtro por credencial:

crawler.prod.judit.io/credentials?customer_key=00000001

Exemplo de resposta para consulta com filtro por credencial:

{
	"systems": [
		{
			"name": "*",
			"customer_key": "",
			"credential_status": "not exists"
		},
		{
			"name": "EPROC - TRF4 - 2º grau",
			"customer_key": "00000001",
			"credential_status": "active"
		}
	]
}

​

Rota para deletar uma chave no cofre de Credenciais

Para deletar um sitema no cofre de credeniais, 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.

Exemplo de payload para deletar credencial:

{
  "system_name": "PJE TJBA - 1º grau"
}

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