Excluir

DELETE/api/v2/baas/key-managements/{id}

Produto BaaS (titular). Requer Bearer JWT do login da conta e assinatura HMAC obrigatória. Scope: baas.key-managements.write. Guia: documentação técnica.

Parâmetros

AcceptObrigatório

header

Tipo:string

X-SignatureObrigatório

header

Assinatura HMAC-SHA256 da requisição (hex).

Tipo:string

X-TimestampObrigatório

header

Timestamp Unix (segundos, UTC) usado na assinatura.

Tipo:string

X-NonceObrigatório

header

Nonce único por requisição (anti-replay).

Tipo:string

idObrigatório

path

Tipo:integer

Autenticação e headers

Requer Bearer token do login da conta e assinatura HMAC obrigatórios. Scope: baas.key-managements.write.

Envie X-Signature, X-Timestamp e X-Nonce em todo pedido assinado. Veja Autenticação do parceiro.

Header	Obrigatório	Descrição
`Authorization`	Sim	`Bearer {{access_token}}`
`Accept`	Sim	`application/json`
`X-Signature`	Sim	Assinatura HMAC
`X-Timestamp`	Sim	Timestamp da assinatura
`X-Nonce`	Sim	Nonce único por requisição

Path

Parâmetro	Descrição
`id`	ID interno da chave `active` a excluir

Códigos

Código	Descrição
204	Chave removida do DICT (sem corpo)
400	Parâmetros inválidos
401	Token ou HMAC inválido
403	Scope ausente
404	Não encontrado
422	Validação ou regra de negócio
500	Erro interno

Notas

Excluir chave do DICT.
Técnica: Chaves Pix.
Visão geral BaaS: Sobre o BaaS.

curl --request DELETE \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/key-managements/1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}'

const axios = require("axios");

axios({
  method: "delete",
  url: "https://api-h.nuvende.com.br/api/v2/baas/key-managements/1",
  headers: {
    Accept: "application/json",
    Authorization: "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
  },
})
  .then((response) => console.log(response.status))
  .catch((error) => console.log(error.response?.data || error.message));

import requests

url = "https://api-h.nuvende.com.br/api/v2/baas/key-managements/1"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
}
response = requests.delete(url, headers=headers)
print(response.status_code)

<?php
$curl = curl_init();
$opts = [
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/key-managements/1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'Authorization: Bearer {{access_token}}',
    'X-Timestamp: {{timestamp}}',
    'X-Nonce: {{nonce}}',
    'X-Signature: {{signature}}',
  ],
];
curl_setopt_array($curl, $opts);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

HTTP 204 No Content (sem corpo JSON). Na assinatura HMAC, use corpo vazio ({} ou string vazia conforme o integrador) de forma consistente com o pedido DELETE.

{
  "message": "Key not found"
}

{
  "message": "An error occurred while deleting the key, please try again in a moment"
}