Cofre
Gravar segundo fator
PUT/v1/cofre/certificados/{certificado_id}/autenticacoes
Cadastra a chave do autenticador (o texto base32 do QR code) de um tribunal e sistema. No PJe o mesmo código vale para todos os tribunais PJe e para o Domicílio, então uma chave atualiza todos de uma vez — a resposta lista quais.
Parâmetros
| Nome | Onde | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
certificado_id |
caminho | uuid | sim | Id do certificado |
Corpo (application/json)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
segredo |
texto | sim | Chave base32 do autenticador |
sistema |
texto | sim | Sistema do tribunal (ex.: PJE) |
tribunal |
texto | sim | Código do tribunal, como em /v1/tribunais (ex.: 8.05) |
Respostas
| HTTP | Significa |
|---|---|
| 200 | OK |
| 422 | Corpo ou parâmetros com formato inválido (detail lista os campos) |
Exemplo de resposta
{
"autenticacoes_atualizadas": [
"0.00:DOMICILIO",
"8.05:PJE",
"8.19:PJE"
]
}
Erros
Recusas vêm como {"detail": {"erro": "<código>", "mensagem": "…"}}.
| HTTP | erro |
Significa |
|---|---|---|
| 401 | — | Chave ausente ou inválida |
| 404 | nao_encontrado |
A Conexão não existe nesta Conta (ou foi revogada) |
| 422 | dados_invalidos |
Chave fora do formato base32 ou sistema sem segundo fator |
| 502 | cofre_indisponivel |
O cofre não respondeu agora. Tente de novo em instantes |