Cria ou edita um perfil de publicação para o destino CURL.
- Endpoint:
/api/certificate/profile/curl
- Método:
POST
- Requisição:
POST /api/certificate/profile/curl
Parâmetros da requisição
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
code_profile |
int |
Não |
Código de perfil existente. Um novo perfil será criado caso não exista um. Editar informando apenas code_profile e name_profile preserva os valores existentes de execution_template e additional_info. |
name_profile |
string |
Sim |
Nome do perfil. |
execution_template |
int |
Sim |
Código do template de execução que descreve a requisição. O tipo de execução do template deve ser Publicação de certificado. |
additional_info |
string |
Não |
Valor que preenche a tag [#CERT_ADD_INFO#] no template de execução. Aceita apenas letras, números, ponto, hífen e sublinhado. |
code_credential |
int |
Condicional |
Código da credencial a ser usada na publicação. Obrigatório se o username não for fornecido. |
username |
string |
Condicional |
Nome de usuário utilizado para localizar credenciais para publicação. Obrigatório se o code_credential não for fornecido. |
devices |
array |
Sim |
Array com códigos de dispositivos onde o certificado deve ser publicado. |
Exemplo utilizando cURL
curl -X POST https://[segura_vault_url]/api/certificate/profile/curl \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name_profile": "Internal webhook - Production",
"execution_template": 45,
"additional_info": "prod-cert",
"username": "admin",
"devices": [101, 102, 103]
}'
Resposta
{
"status": 200,
"message": "Profile created successfully",
"error": false,
"code_profile": 22,
"name_profile": "Internal webhook - Production",
"execution_template": 45,
"additional_info": "prod-cert",
"username": "admin",
"devices": [101, 102, 103]
}
Respostas de erro
| Código de status HTTP |
Descrição |
| 400 Bad Request |
Parâmetros inválidos fornecidos. |
| 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. |
Códigos de erro específicos do CURL
| Código de status HTTP |
Código interno |
Causa |
| 400 Bad Request |
1078 |
O campo execution_template não foi informado. |
| 400 Bad Request |
1079 |
O execution_template não existe, está inativo, ou não é um template de Publicação de certificado. |
| 400 Bad Request |
1080 |
O campo additional_info contém um caractere diferente de letra, número, ponto, hífen ou sublinhado. |