Girar o segredo de uma chave

Emite um segredo novo e invalida o anterior na mesma transação. Escopos e produtos vinculados são preservados.

POSThttps://api.navenaut.com/api-keys/{id}/rotate-secret

Autenticação

A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.

Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.

Exige sessão de vendedor. A chave de API não autentica esta rota: uma chave não pode emitir nem revogar outra chave.

Parâmetros

Caminho

Nome	Tipo	Descrição
`id`obrigatório	texto	O identificador da chave, como ele aparece na listagem. Nunca o segredo.

Respostas

200 · sucesso

{
  "id": "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06",
  "productRefs": [
    "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06"
  ],
  "secret": "valor-de-exemplo-nao-use"
}

404 · não encontrado

A chave não existe, ou não é sua.

Erros desta rota

Status	Código	Quando	O que fazer
404	`API_KEY_NOT_FOUND`	O identificador não existe, ou a chave é de outra conta. As duas causas respondem igual de propósito: distinguir revelaria a existência de chave alheia.	Confira o identificador na listagem de chaves. Repetir não muda o resultado: o segredo anterior continua valendo, porque nenhum segredo novo foi emitido.

Os códigos são estáveis e fazem parte do contrato. A lista completa, com todos os vocabulários, está na tabela de erros.