Pular para o conteúdo principal
GET
Obter certificado do banco de dados
string
obrigatório
O ID do banco de dados do qual obter o certificado.

Resposta

A resposta é um objeto JSON com os componentes do certificado em PEM para a conexão TLS com o banco de dados, além da CA e de um bundle PKCS#12 quando o banco de dados os tiver.
object
Os detalhes do certificado para conexões seguras com o banco de dados.

Uso

Todos os motores exigem TLS e o certificado do cliente. Salve cada campo em um arquivo: Use ca.pem (ou certificate.pem, que termina com a mesma CA) como arquivo de CA e, no MongoDB, certificate.pem como arquivo de certificado com chave. Use certificate.crt + certificate.key como certificado do cliente, ou certificate.p12 quando o driver aceitar apenas uma identidade PKCS#12 (Prisma 6, com senha vazia). A porta é única por banco de dados — leia-a em Obter banco de dados. Comandos e exemplos de driver para cada motor estão em Como me conecto a cada motor?.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: O header Authorization está ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: A chave de API é usada a partir de um IP fora da sua lista de IPs permitidos, ou não tem o escopo que a rota exige (403).
  • ACCESS_DENIED: O recurso pertence a outra conta, ou você não tem a permissão de workspace para ele (403).
  • DATABASE_NOT_FOUND_OR_FORBIDDEN: O banco de dados informado não existe ou o usuário não tem acesso.
  • FAILED_TO_GET_CERTIFICATE: Falha ao obter o certificado.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
Última modificação em 28 de outubro de 2026