Chaves em massa e exportação
Crie ou importe até mil chaves, aja em até quinhentas de uma vez e exporte como JSON ou CSV.
POST de chaves em lote aceita JSON de até 512 KiB. POST/PUT de código aceita 4 MiB; outras requisições têm limite padrão de 16 KiB. Escrita exige keys:write; exportação exige chave ativa com acesso ao projeto.
Criar muitas chaves
POST /v3/projects/:id/users/bulk
Envie count (1 a 1000) para criar essa quantidade de chaves, ou users (1 a 1000) para trazer chaves que você já tem, como ao migrar do Luarmor. Um ou outro, não os dois.
{ "count": 200, "note": "Giveaway", "key_days": 30 }{
"users": [
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "note": "from Luarmor", "discord_id": "123456789012345678", "auth_expire": 1893456000 }
]
}Com count, note, key_days e auth_expire valem como para uma chave (vitalícia quando nenhum fim é dado). Com users, cada item traz user_key (32 letras) e, se quiser, note, discord_id, identifier, key_days ou auth_expire. A resposta tem created e, para count, as user_keys; para users, uma lista skipped das chaves que já existiam (código KEY_EXISTS). O limite de chaves do plano é checado sob um bloqueio: uma chamada que não cabe não cria nada (403 PLAN_LIMIT), e chamadas simultâneas não passam juntas do limite.
Agir em muitas chaves
| Route | O que faz |
|---|---|
| POST /v3/projects/:id/users/bulk/ban | Bane as chaves (reason, until como para uma chave). A resposta traz o objeto unban_tokens, um token por chave. |
| POST /v3/projects/:id/users/bulk/unban | Retira os banimentos. |
| POST /v3/projects/:id/users/bulk/resethwid | Libera as chaves de seus dispositivos (reset-hwid também serve). Ignora o cooldown do projeto, como a redefinição de um dono. |
| POST /v3/projects/:id/users/bulk/delete | Exclui as chaves. Cada uma vai para o log de auditoria. |
| POST /v3/projects/:id/users/bulk/extend | Soma days (1 a 36500). Uma chave que já terminou recebe os dias a partir de hoje; uma ainda ativa os recebe somados ao fim; uma chave "dias desde o primeiro uso" não usada ganha mais dias; uma vitalícia é deixada como está e listada em unchanged. |
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }user_keys traz de 1 a 500 chaves (repetidas contam uma vez). A resposta tem updated e not_found, as chaves que não estão neste projeto (chaves de outro projeto ou workspace parecem iguais). Cada mudança vai para o histórico das chaves com o nome da chave de API.
Exportar chaves
GET /v3/projects/:id/users/export
| Parâmetro | Significado |
|---|---|
| format | json (padrão) ou csv. |
| status | unused, active, reset ou banned. |
| limit | Chaves por chamada, de 1 a 50000; padrão 10000. |
| cursor | O next_cursor da chamada anterior. |
As chaves vêm do mais antigo ao mais novo e as páginas se encaixam sem repetir nem faltar, mesmo para chaves criadas no mesmo instante. O JSON responde users, count e next_cursor (null na última página). O CSV tem uma linha de cabeçalho e as mesmas colunas de uma chave na lista; o cursor vem no cabeçalho X-Next-Cursor. Uma célula que começa com =, +, - ou @ é escrita com uma aspa na frente para a planilha mostrá-la como texto, nunca como fórmula.