API REST v1

Documentação da API

A API MyProc permite integrar o monitoramento de processos diretamente ao seu sistema. Todos os endpoints retornam JSON e usam autenticação via Bearer Token.

URL base: https://api.myproc.com.br/v1

Autenticação

Todas as requisições devem incluir o header Authorization com seu token de API, gerado em Configurações → Integrações → Gerar token.

// Header obrigatório em todas as requisições
Authorization: Bearer seu_token_aqui
Content-Type: application/json

Códigos de status

Código	Significado
`200`	Sucesso
`201`	Recurso criado
`400`	Requisição inválida
`401`	Não autenticado — token ausente ou inválido
`403`	Sem permissão para este recurso
`404`	Recurso não encontrado
`429`	Rate limit atingido
`500`	Erro interno — contate o suporte

Listar processos

GET /processos

Retorna a lista de processos monitorados da conta.

Parâmetros de query

Parâmetro	Tipo	Descrição
`page`	integer	Página (padrão: 1)
`per_page`	integer	Itens por página — máx. 100 (padrão: 20)
`tribunal`	string	Filtrar por sigla do tribunal (ex: TJMG)
`status`	string	`ativo` \| `extinto` \| `todos`

GET /v1/processos?tribunal=TJMG&status=ativo

// Resposta 200
{
"data": [{ "id": "proc_7f3a9c", "numero_cnj": "5014509-20.2024.8.13.0114", "tribunal": "TJMG" }],
"meta": { "total": 148, "page": 1 }
}

Buscar processo

GET /processos/{id}

Retorna os detalhes completos de um processo, incluindo partes e últimas movimentações.

Cadastrar processo

POST /processos

Adiciona um processo ao monitoramento.

POST /v1/processos

{ "numero_cnj": "5014509-20.2024.8.13.0114", "alias": "Processo João Silva", "notificar_emails": ["advogado@exemplo.com"] }

Remover processo

DELETE /processos/{id}

Remove o processo do monitoramento. Esta ação não pode ser desfeita.

Listar movimentações

GET /processos/{id}/movimentacoes

Retorna o histórico de movimentações de um processo ordenado por data decrescente.

Webhooks

Configure uma URL para receber notificações em tempo real sempre que uma nova movimentação for detectada.

Seu endpoint deve responder com HTTP 200 em até 5 segundos. Falhas consecutivas desativam o webhook automaticamente.

// Payload enviado ao seu endpoint
{ "evento": "nova_movimentacao", "processo_id": "proc_7f3a9c", "movimentacao": { "data": "2026-05-11T09:14:00Z", "descricao": "Juntada de petição" } }

Gerenciar usuários

GET /usuarios

Lista os usuários da conta com seus perfis de acesso.

POST /usuarios/convite

Envia convite por e-mail para um novo usuário com o perfil especificado.