Cofre

Cadastrar certificado

POST/v1/cofre/certificados

Envia o certificado A1 (.pfx) e a senha para o cofre. O arquivo e a senha não ficam no Sync: a resposta traz só os metadados. Um certificado ativo por titular — para renovar, revogue o antigo antes.

Corpo (multipart/form-data)

Campo Tipo Obrigatório Descrição
arquivo arquivo sim Arquivo .pfx do certificado A1 (até 1 MB)
rotulo texto não Nome para reconhecer o certificado na Conta (padrão Certificado A1)
senha texto sim Senha do certificado

Respostas

HTTP Significa
201 Criado
422 Corpo ou parâmetros com formato inválido (detail lista os campos)

Exemplo de resposta

{
  "id": "5b1e7c2a-3f4d-4c8e-9a1b-2d6f0e8c7a15",
  "tipo": "certificado",
  "rotulo": "A1 Dra. Fulana",
  "criada_em": "2026-09-26T12:00:00+00:00",
  "titular": "FULANA DE TAL",
  "valido_ate": "2027-03-01",
  "autenticacoes": [],
  "autenticacoes_recusadas": []
}

Erros

Recusas vêm como {"detail": {"erro": "<código>", "mensagem": "…"}}.

HTTP erro Significa
401 — Chave ausente ou inválida
409 titular_ja_cadastrado Já há certificado ativo deste titular. Revogue o antigo antes
413 arquivo_grande_demais O arquivo passa de 1 MB
422 dados_invalidos O cofre recusou o arquivo ou a senha; a mensagem diz o motivo
502 cofre_indisponivel O cofre não respondeu agora. Tente de novo em instantes