Chaves de API
Chaves sgk_ da organização para integrações servidor a servidor.
Criar chave de API de integração
Cria uma chave de API de integração da organização e devolve o segredo uma única vez, aceitando `expires_at` e `allowed_cidrs`. As permissões devem estar entre as permissões efetivas de quem cria (ou ser copiadas de `from_role_id`); permissões não permitidas retornam `400` `api_key_forbidden_permission`. Responde `201` e requer a permissão `identity.api_keys.manage`.
Listar chaves de API
Lista as chaves de API da organização. Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Requer a permissão `identity.api_keys.read`.
Consultar chave de API
Devolve os dados de uma chave (sem o segredo): prefixo, permissões, validade, CIDRs, finalidade, último uso e revogação. `key_id` é o código público de 4 caracteres. Requer a permissão `identity.api_keys.read`.
Atualizar chave de API
Altera nome, permissões, `expires_at` ou `allowed_cidrs` de uma chave (`key_id` é o código público). As permissões devem estar entre as permissões efetivas de quem chama (`400` `api_key_forbidden_permission`). Requer a permissão `identity.api_keys.manage`.
Revogar chave de API
Revoga imediatamente uma chave da organização (`key_id` é o código público) e avisa quem acompanha as chaves. Chave já revogada retorna `404`. Requer a permissão `identity.api_keys.manage`.