Bloquear e desbloquear
Bloqueia a key no loader — o cliente não entra até você desbloquear. O tempo continua correndo.
/keys/{user_id}/blockPermissão do token: Bloquear keys keys:block
Bloqueada, a key não entra no loader: o cliente vê "Access is stopped." até você desbloquear. O tempo continua correndo — bloquear não congela a key, ela continua vencendo na data de sempre. Não gasta créditos.
Para desbloquear, a mesma chamada em /unblock:
/keys/{user_id}/unblockPermissão do token: Bloquear keys keys:block
Parâmetros no endereço
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
user_id | número | Sim | O user_id da key — vem na geração e na lista de keys. |
A chamada não tem corpo.
Resposta
blocked diz como a key ficou, e blocked_by quem bloqueou: reseller (você) ou support. Repetir o pedido não é erro: bloquear uma key já bloqueada devolve blocked: true de novo. Na lista de keys, a key aparece com blocked: true.
Você só desbloqueia o que você bloqueou. Uma key bloqueada pelo suporte ou pelo sistema antifraude (por exemplo, por uso em vários PCs) aparece com blocked_by: "support", e o desbloquear responde 403: só o suporte libera. Bloquear essa key de novo não a torna sua.
Erros
| HTTP | Quando |
|---|---|
401 | Token ausente, inválido, apagado ou vencido. |
403 | O token não tem a permissão Bloquear keys, a key não é sua, é uma key de gravação (essa não é bloqueada por aqui), ou — no desbloquear — a key foi bloqueada pelo suporte. |
404 | A key não tem acesso na loja. |
422 | Key antiga que aponta para a conta de um cliente da loja, e não para uma conta de key: bloquear pararia os VIPs dele. Fale com o suporte. |
429 | Passou do limite. |