---
title: "POST | Baixar o certificado"
slug: "api-clm-download-certificates"
updated: 2026-04-28T15:11:24Z
published: 2026-04-28T15:11:24Z
canonical: "docs.senhasegura.io/api-clm-download-certificates"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# POST | Baixar o certificado

Baixa o certificado digital em diversos formatos. A API suporta diferentes tipos de exportação e fornece opções para gerenciar chaves privadas e criptografias.

- ***Endpoint***: `/api/certificate/download`
- **Método**: `POST`
- **Requisição**: `POST /api/certificate/download`

## Parâmetros da requisição

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `int` | Sim | ID utilizado para localizar e recuperar o certificado. |
| `format` | `string` | Sim | Formato do arquivo para o certificado. Valores suportados: `pfx`, `pem`, e `crt`. |
| `download_key` | `string` e `boolean` | Não | Se `true`, inclui a chave privada dentro do certificado no *download*. Para o formato `.crt`, a chave vem separadamente. Para `.pfx`, a chave sempre é incluída e este campo é ignorado, e para `.pem` a chave é opcional. |
| `password` | `string` | Condicional | Senha para criptografar o arquivo. Obrigatório para o formato `pfx`. Para os formatos `pem` e `crt`, é obrigatório somente caso o parâmetro `download_key` for `true`. |

### Formato das respostas

#### Resposta do formato PFX

```
{
  "certificate": "MIID6TCCAtGgAwIBAgIBADA...",
  "format": "pfx"
}
```

#### Resposta do formato PEM

```
{
  "certificate": "MIID6TCCAtGgAwIBAgIBADA...",
  "format": "pem"
}
```

#### Resposta do formato CRT

Quando o parâmetro `download_key` é `false` (padrão):

```
{
  "certificate": "MIID6TCCAtGgAwIBAgIBADA...",
  "format": "crt"
}
```

Quando `download_key` é `true`:

```
{
  "certificate": "MIID6TCCAtGgAwIBAgIBADA...",
  "format": "pfx"
  "key": "MIID6TCCAtGgAwIBAgIBADA...",
  "key_format": "key"
}
```

### Exemplos de requisições

#### *Download* básico do certificado (Formato PFX)

```
curl -X POST https://[segura_vault_url]/api/certificate/download \
  -H "Content-Type: application/json" \
  -d '{
    "id": "12345",
    "format": "pfx",
    "password": "securepassword123"
  }'
```

#### Certificado com uma chave privada (Formato CRT)

```
curl -X POST https://[segura_vault_url]/api/certificate/download \
  -H "Content-Type: application/json" \
  -d '{
    "id": "12345",
    "format": "crt",
    "download_key": true,
    "password": "keyprotectionpassword"
  }'
```

### Considerações de segurança

1. Sempre transmita solicitações via HTTPS para proteger dados sensíveis de certificados e senhas.
2. Use senhas fortes ao criptografar chaves privadas ou arquivos `.pfx`.
3. Implemente controle de acesso adequado para garantir que apenas usuários autorizados possam baixar certificados.

### Respostas de erro

| Código de status HTTP | Descrição |
| --- | --- |
| **400 Bad Request** | Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido). |
| **401 Unauthorized** | Acesso não autorizado para baixar o certificado. |
| **403 Forbidden** | Permissões insuficientes para baixar o certificado solicitado. |
| **404 Not Found** | Certificado com o ID especificado não foi encontrado. |
| **500 Internal Server Error** | Erro do lado do servidor ocorreu durante o processamento do certificado. |

### Observações

- Os dados do certificado e chave na resposta estão codificados em Base64.
- Quando `download_key` é definido como `true` e uma senha é fornecida, a chave privada será criptografada usando a senha fornecida.
- O formato `.pfx` sempre inclui tanto o certificado quanto a chave privada em um único arquivo.