Cadastrar novo monitoramento

Este endpoint permite cadastrar um novo processo (CNJ) para monitoramento contínuo.

Após o cadastro, o processo será pesquisado automaticamente em toda a abrangência compatível com a numeração informada. Caso localizado, passará a ser monitorado periodicamente para identificação de novas movimentações.

Observação 1

Caso utilize callback e deseje receber apenas novas atualizações, envie a propriedade ignore como true.

Isso indica que movimentações anteriores ao momento do cadastro não serão reenviadas.

Observação 2

É possível enviar headers customizados para serem utilizados nos callbacks.

Todos os envios realizados pela Codilo incluirão obrigatoriamente o header:

User-Agent: CodiloCallback/1.0 (+http://codilo.com.br/)

Requisição

POST https://api.push.codilo.com.br/v1/processo/novo

Parâmetros

Nome	Tipo	Obrigatório	Descrição
cnj	string	true	Número do processo no formato CNJ (NNNNNNN-DD.AAAA.J.TR.OOOO)
callbacks	array	false	Lista de endpoints para recebimento via callback
ignore	boolean	false	Quando true, ignora movimentações anteriores ao cadastro

Exemplos de Requisição

cURL

curl --request POST \
  --url https://api.push.codilo.com.br/v1/processo/novo \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "cnj": "0030779-57.2015.8.10.0001",
    "ignore": false,
    "callbacks": [
      {
        "method": "POST",
        "url": "https://callback.seudominio.com.br",
        "headers": {
          "My-Custom-Header": "My-Custom-Header-Value"
        }
      }
    ]
  }'

Python

import requests

headers = {
    "Authorization": "Bearer SEU_ACCESS_TOKEN",
    "Content-Type": "application/json",
}

payload = {
    "cnj": "0030779-57.2015.8.10.0001",
    "ignore": False,
    "callbacks": [
        {
            "method": "POST",
            "url": "https://callback.seudominio.com.br",
            "headers": {
                "My-Custom-Header": "My-Custom-Header-Value",
            },
        }
    ],
}

response = requests.post(
    "https://api.push.codilo.com.br/v1/processo/novo",
    headers=headers,
    json=payload
)

print(response.json())

PHP

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.push.codilo.com.br/v1/processo/novo');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SEU_ACCESS_TOKEN',
    'Content-Type: application/json',
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "cnj" => "0030779-57.2015.8.10.0001",
    "ignore" => false,
    "callbacks" => [
        [
            "method" => "POST",
            "url" => "https://callback.seudominio.com.br",
            "headers" => [
                "My-Custom-Header" => "My-Custom-Header-Value"
            ]
        ]
    ]
]));

$response = curl_exec($ch);

curl_close($ch);

echo $response;

Node.js

fetch("https://api.push.codilo.com.br/v1/processo/novo", {
  method: "POST",
  headers: {
    Authorization: "Bearer SEU_ACCESS_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    cnj: "0030779-57.2015.8.10.0001",
    ignore: false,
    callbacks: [
      {
        method: "POST",
        url: "https://callback.seudominio.com.br",
        headers: {
          "My-Custom-Header": "My-Custom-Header-Value",
        },
      },
    ],
  }),
});

Exemplo de Resposta (200 - OK)

Sucesso

{
  "success": true,
  "data": {
    "id": "43e595f8-716f-464b-9c2a-5c4318bd787c",
    "cnj": "0030779-57.2015.8.10.0001",
    "createdAt": "2022-03-11T13:16:52.894Z",
    "info": [
      {
        "id": "796f03a3-3468-4c80-b515-8192b495b2bf",
        "source": "Consulta de Tribunais",
        "platform": "Jurisconsult",
        "search": "Tribunal de Justiça do Maranhão",
        "query": "Consulta de Processos de 1º Grau"
      }
    ]
  }
}

Status Codes

Status	Significado	Descrição
200	OK	Processo cadastrado com sucesso
400	Invalid CNJ	Formato CNJ inválido (NNNNNNN-DD.AAAA.J.TR.OOOO)
401	Unauthorized	Token inválido ou não informado