Primeiros passos

Todas as rotas ficam sob o endereço do painel, em /api (ex.: https://painel.seudominio/api/processos/download). Se a API tiver domínio próprio, use-o sem o /api.

1. Entre e crie uma API key

Um administrador envia o convite; ao aceitar, você define a senha. No painel, em API keys, crie uma chave. Ela aparece uma única vez — guarde-a como uma senha. Todas as chamadas levam:

Authorization: Bearer crw_...

2. Cadastre o certificado A1 (uma vez)

curl -X POST https://painel.seudominio/api/certificados \
  -H "Authorization: Bearer crw_..." \
  -F "arquivo=@certificado.pfx" -F "senha=SENHA" -F "totp=SEGREDO_2FA"

O certificado é conferido na hora (senha, validade) e guardado cifrado. Nenhuma rota devolve o arquivo, a senha ou o TOTP.

3. Peça o download de um processo

curl -X POST https://painel.seudominio/api/processos/download \
  -H "Authorization: Bearer crw_..." -H "Content-Type: application/json" \
  -d '{"numero": "0001234-05.2023.8.13.0024"}'

A resposta chega na hora com o job_id. Número inválido, tribunal sem suporte ou falta de certificado respondem 422 com o motivo.

4. Acompanhe e baixe o PDF

curl https://painel.seudominio/api/processos/download/42 \
  -H "Authorization: Bearer crw_..."

Quando status for sucesso, baixe o PDF em arquivo.url com a mesma chave. Detalhes e estados em Download de processos.