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