POST | Criar ou editar um perfil de publicação cURL

Prev Next

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.