PJeCor – Manual de acesso e utilização do PJeCor-Tools

Banner/header com a logomarca do PJeCor

 

O PJeCor-Tools é um projeto criado para agregar serviços de auxílio à gestão do PJeCor nas corregedorias regionais.

Os serviços devem ser acessados, preferencialmente, por sistema desenvolvido pelo Tribunal, de forma a permitir a automação das rotinas de consulta e posterior tratamento das informações disponibilizadas.

Como solicitar o acesso

O acesso de cada jurisdição aos serviços do PJeCor-Tools será disponibilizado através de um token.

Para solicitar este token, cada Tribunal deve enviar um ofício à Corregedoria Nacional, informando:

  1. Nome da Jurisdição no PJeCor;
  2. Ambiente de acesso(treinamento ou produção);
  3. Nome e e-mail do responsável pelo token no Tribunal;
  4. Endereço de e-mail que receberá o token gerado.

É responsabilidade do Tribunal zelar pelo sigilo do token, uma vez que este permite acesso irrestrito aos serviços providos pelo PJeCor-Tools dentro de sua jurisdição.

Serviços disponíveis

Serviço de consulta e download dos metadados dos processos

Este serviço gera uma cópia diária dos processos de cada jurisdição. O arquivo está em formato ZIP e atualmente contém três documentos:

      1. Cabeçalho dos processos
      2. Histórico de tarefas de cada processo
      3. Histórico de movimentações de cada processo

O objetivo é que cada Tribunal possa baixar estes arquivos diariamente e atualizar uma base local, permitindo a elaboração de relatórios e/ou painéis de acompanhamento.

Este serviço é composto por duas requisições: uma para gerar a URL de download, e a outra para fazer o download do arquivo zip.

Gerando a URL para download

Enviar uma requisição do tipo POST para o endereço https://pjecor-tools.stg.cloud.cnj.jus.br/dump/{dia} (TREINAMENTO) ou https://pjecor-tools.cloud.cnj.jus.br/dump/{dia} (PRODUÇÃO), onde o parâmetro {dia} deve estar no formato yymmdd. O token deve ser enviado no cabeçalho http Bearer, e o cabeçalho Accept deve conter o valor application/json

Exemplo de requisição (PHP)

$options = array('http' => array(
    'method'  => 'POST',
    'header'=>"Authorization: Bearer JbrBPGEubN3hF22NQ9OgpIfjFgqAlM1K6P3ueyGf\r\n" .
                "Accept: application/json\r\n"
));
$context  = stream_context_create($options);
$body = json_decode(file_get_contents("https://pjecor-tools.stg.cloud.cnj.jus.br/dump/220517",false, $context));
$url = $body->url;

Caso o token seja validado com sucesso e exista arquivo disponível no dia solicitado, o servidor retornará uma resposta no formato JSON, contendo a URL para download.

De posse da URL, basta fazer uma requisição GET padrão pra efetuar o download do arquivo Zip.