Ciclo de vida das chaves de API

Chaves de API pertencem a uma conta, não a um projeto. Use a mesma chave em todos os projetos que a conta pode acessar. Os endpoints de gerenciamento usam a autenticação normal da conta, portanto uma sessão Logto ou uma chave ativa da conta pode chamá-los. Trate a chave como credencial da conta, não como token limitado a um projeto.

Endpoints

GET    /api/v1/keys
POST   /api/v1/keys
PATCH  /api/v1/keys/{key_id}/activate
PATCH  /api/v1/keys/{key_id}/deactivate
DELETE /api/v1/keys/{key_id}

Crie uma chave com um nome opcional:

POST /api/v1/keys
Content-Type: application/json

{"name": "ingestão de produção"}

A resposta 201 é a única que contém key, cujo valor começa com fnf_. Copie-o imediatamente. A ReOpenly armazena somente um digest, um prefixo mascarado e os quatro últimos caracteres, portanto não consegue recuperar a chave depois.

Listagem segura

GET /api/v1/keys sempre retorna uma página limitada por cursor (25 linhas por padrão). Não é necessário ativar um modo; os cursores pertencem à sua conta:

GET /api/v1/keys?limit=25
GET /api/v1/keys?limit=25&cursor=<next_cursor>

A resposta é {data, next_cursor, total_count} e o limite máximo é 100. Cada linha tem id, name, masked_key, active, created_at e last_used_at, mas nunca uma credencial funcional.

Desativar é reversível e interrompe a autenticação imediatamente. Ativar restaura a mesma chave. Excluir é permanente; crie a substituta antes de excluir uma chave usada por uma integração ativa.