---
title: "POST | Importar um certificado SSL"
slug: "api-clm-import-ssl-certificate"
updated: 2026-03-04T12:05:18Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-clm-import-ssl-certificate"
---

> ## 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 | Importar um certificado SSL

Importa um certificado SSL no sistema.

- ***Endpoint***: `/api/v1/certificates/import`
- **Método**: `POST`
- **Requisição**: `POST /api/v1/certificates/import`

## Parâmetros da requisição

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `certificate` | `string` | Sim | Arquivo de certificado codificado em Base64. |
| `private_key` | `string` | Não | Arquivo de chave privada codificado em Base64. Se vazio, a chave não estará disponível no sistema, limitando o uso do certificado, publicação e associação de dispositivos. Nota: arquivos `.pfx` já inclui uma chave privada. |
| `password` | `string` | Não | Senha para recuperar o certificado correspondente. |
| `revoke_password` | `string` | Não | Senha para revogar o certificado SSL associado. |
| `extension` | `string` | Sim | Extensão do arquivo do certificado. |

### Exemplo utilizando cURL

```
curl -X POST https://[segura_vault_url]/api/certificate/import \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUVCVENDQW...",
    "private_key": "LS0tLS1CRUdJTiBQUklWQVRFIEtFWS0tLS0tCk1JSUV2UUlCQU...",
    "password": "certpass123",
    "revoke_password": "revokepass456",
    "extension": "crt"
  }'
```

### Resposta

```
{
  "status": 200,
  "message": "Certificate imported successfully",
  "error": false,
  "code_certificate": 789,
  "common_name": "api.example.com",
  "issuer": "GlobalSign",
  "validity_start": "2024-01-15",
  "validity_end": "2025-01-15"
}
```

### 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. |
| **403 Forbidden** | Permissão negada. |
| **404 Not Found** | Recurso não encontrado. |
| **500 Internal Server Error** | Erro interno do servidor. Por exemplo: certificado inválido ou vazio, chave privada inválida ou vazia. |