Apresentação

Introdução

O Recorte Eletrônico permite o acesso às publicações selecionadas para um cliente via API REST. Esse tipo de acesso foi projetado para simplificar a interface do Recorte Eletrônico com outros sistemas. O acesso é feito através de requisições http simples. As requisições contém parâmetros para selecionar os dados desejados. As respostas são fornecidas em formato JSON. As requisições devem ser feitas usando https com o corpo também em JSON.

Abaixo seguem algumas das principais funções com exemplos para obter as publicações

POST /usuarios/login - cria um token de acesso.

Este token é necessário para acessar as demais funcionalidades. O token de acesso vale por um período a partir do momento em que foi gerada. Passado esse tempo é necessário gerar outro token para continuar utilizando.

exemplo: HTTP POST https://servico.snap.com.br/recorte/v1/usuarios/login

Enviando no Request body:
{
     "usuario": "email@dousuario.com.br",
     "senha": "senhaDoUsuario"  
  }
  
Sendo o email@dousuario.com.br obrigatoriamente um e-mail cadastrado no sistema do Recorte Eletrônico. Entre em contato com o suporte da SNAP para mais detalhes.

Se as informações de login estiverem corretas ele retorna em uma resposta HTTP 200
    {
      "accessToken": "jklasgdfkjahsdjkfhjkh4kjlh2jk3h4jk2h3kj",
      "expiresIn": 1000,
      "tokenType": "string"
    }
Para acessar as outras funções como, /publicacoes, por exemplo, O accessToken deve ser sempre enviado no header da requisição HTTP na forma abaixo
Authorization: Bearer jklasgdfkjahsdjkfhjkh4kjlh2jk3h4jk2h3kj





Porém, se não sabe a senha ou é a primeira vez utilizando a api do Recorte, vai ser necessário criar uma senha de acesso associada ao e-mail do usuário.
Para criar uma nova senha de acesso, primeiro você solicita um PIN para validar o email do usuário.

Em posse do accessToken, você pode fazer uma requisição para...



GET /publicacoes - cria um token de acesso.

Para obter uma lista das publicações disponíveis.

Lembrando de sempre passar o Authorization: Bearer accessToken no header da requisição.


A lista retornada pode ser muito grande, por isso existem alguns parâmetros para filtrar, paginar ou resumir.

exemplo: HTTP GET https://servico.snap.com.br/recorte/v1/publicacoes

https://servico.snap.com.br/recorte/v1/publicacoes?desde=2020-05-01&limit=100&comTexto=true
Lista 100 publicações (ids) com data posterior a 01/05/2020, incluindo ainda o texto da publicação.


O texto e outros detalhes da publicação, se preferir, podem ser recuperado individualmente fazendo uma requisição diretamente para uma publicação específica, informando o Id na url



GET /publicacoes/{idPublicacao} - obtem detalhes de uma publicação a partir do Id.

exemplo: GET https://servico.snap.com.br/recorte/v1/publicacoes/123?comTexto=true&comEdicao=true

onde 123 é o ID da publicação retornado, por exemplo, pela funcção /publicacoes.
Nesse caso pedimos ainda o texto da publicação e a edição, contendo o nome do jornal e a data de publicação.
Clique no link acima para ver a lista completa de parâmetros aceitos.




GET /publicacoes/ids - Retorna lista de Ids das publicações segundo um critério.

Se quiser capturar apenas as publicações novas, ainda não vistas, a recomendação é sempre guardar o maior id da publicação e usar essa chamada

passando por exemplo, /publicacoes/ids?idPublicacao=42

onde 42 é o o maior Id que tenho guardado
Assim, ele retorna uma lista de publicações com ids maiores (ou mais novos) que 42




POST /usuarios/login/pin/solicita - solicita Pin para validar email do usuário.

Para criar uma nova senha de acesso, primeiro você solicita um PIN para validar o email do usuário.

Obs.: Como no Login, para usar esse serviço não é necessário um Token de acesso
exemplo: HTTP POST https://servico.snap.com.br/recorte/v1/usuarios/login/pin/solicita

Enviando no Request body:
{
    "assunto": "Texto para assunto do email",
    "email": "email@dousuario.com.br",
    "marca": "_marcaPIN_",
    "texto": "O seu PIN de acesso é _marcaPIN_"
  }
  
Sendo o email@dousuario.com.br obrigatoriamente um e-mail cadastrado no sistema do Recorte Eletrônico. Entre em contato com o suporte da SNAP para mais detalhes.
O usuário vai receber um email com o texto e o assunto informado, sendo que a "marca" (_marcaPIN_) é substituída pelo código de confirmação numérico (PIN) que ele deve informar no próximo passo para a definição da senha.




POST /usuarios/login/pin/reset - define uma nova senha de usuário passando o PIN recebido no e-mail.

Este token é necessário para acessar as demais funcionalidades. O token de acesso vale por um período a partir do momento em que foi gerada. Passado esse tempo é necessário gerar outro token para continuar utilizando.

exemplo: HTTP POST https://servico.snap.com.br/recorte/v1/usuarios/login/pin/reset

Enviando no Request body:
{
  
    "pin": "123456",
    "senha": "MinhaNovaSenha689",
    "usuario": "email@dousuario.com.br"
  
  }
  
Sendo 123456 o PIN numérico recebido no email do usuário após o passo anterior.
E no campo senha, a nova senha que o usuário deseja utilizar para acessar o sistema na função de Login
Com a senha criada é só fazer o Post de Login para receber o token de acesso que serve para usar todas as outras funções da API Recorte Eletronico

SNAP Informática

A SNAP Informática é especializada em consulta processual automatizada. Focada em desenvolvimento de softwares para o setor jurídico.

Nosso compromisso há mais de três décadas é desenvolver tecnologias pioneiras e produtos inovadores. Foi caminhando neste sentido que participamos da primeira eleição eletrônica do país. O contato com a área jurídica tornou-se permanente, propiciando à empresa entender as novas necessidades destes clientes por produtos capazes de otimizar e gerenciar as rotinas processuais, dado o volume e a diversidade deste material.

A ferramenta DataVenia veio suprir a demanda de gerenciamento de processos no setor jurídico. Para acelerar as pesquisas por intimações nos diários oficiais da justiça, foi lançado o Recorte Eletrônico. A utilização destes dois softwares respondeu as expectativas dos escritórios jurídicos quanto à economia de tempo nas suas rotinas.

Inspirada pelo conceito de criar produtos inteligentes, a SNAP continua inovando com o lançamento do PUSH. Esta moderna ferramenta dinamizou as buscas por novos andamentos nos processos, sendo capaz de atualizá-los via e-mail.

No ano de 2010, a família de produtos SNAP ganhou um novo integrante, o Isis, pensado a partir de uma arquitetura voltada a serviços (SOA), independente da tecnologia de banco de dados, sistema operacional ou linguagem de programação, o ISIS interage com seu sistema atualizando de forma automatizada os andamentos dos processos físicos e eletrônicos, as intimações físicas e eletrônicas dos diários da justiça, os autos dos processos eletrônicos e, ainda contempla uma sofisticada solução de capcha.

Se desejar, a SNAP Informática também oferece Desenvolvimento de Softwares customizados às necessidades da sua empresa.

Conheça os nossos produtos! Visite snap.com.br