Antes de começar
O que você precisa
Seção intitulada “O que você precisa”- O slug do seu órgão. Uma palavra curta em minúsculas que identifica o tribunal no emMãos. Você recebe no onboarding.
- Um usuário no diretório do seu órgão. Cada órgão tem o próprio diretório de identidade; o usuário é criado lá, não por autocadastro.
- O documento a comunicar já armazenado, com a chave e o digest SHA-256 em mãos.
Ambientes
Seção intitulada “Ambientes”| Ambiente | Endereço |
|---|---|
| Produção | https://api.emmaos.com.br |
| Homologação | https://staging.api.emmaos.com.br |
Comece por homologação. Em produção, toda mensagem enviada chega de verdade a um cidadão.
Três regras que valem para tudo
Seção intitulada “Três regras que valem para tudo”1. O órgão vem do token. Nunca de parâmetro, cabeçalho ou subdomínio. Não
existe forma de pedir dado de outro órgão, e um id que exista em outro tribunal
responde 404, não 403: do ponto de vista do seu token, ele não existe.
2. Datas são ISO 8601 em UTC, com milissegundos. 2026-09-07T14:32:05.123Z.
Vale para o que você envia e para o que recebe.
3. A primeira chamada depois de um tempo ocioso pode responder 503. O banco
de cada órgão escala a zero quando ninguém o usa. Isso não é erro: é para
repetir. Ver Erros e novas tentativas.