uloggdDesenvolvedores
Portal do desenvolvedoruloggd
ComeçarRecursosArcade
Portal do desenvolvedoruloggdVisão geralAutenticaçãoEscoposLimites de usoErrosPaginaçãoVersionamento

Limites de uso

Contados por chave, e não por conta, e informados em toda resposta.

As cotas são contadas por chave, não por conta. Uma integração barulhenta não consegue gastar a cota que o dono precisa para usar o site, e um script desgovernado não tranca ninguém fora da própria conta.

CotaPor horaAlcança
read600Toda leitura fora do catálogo.
write60Toda criação, alteração e remoção.
catalog1000Consultas ao catálogo, contadas à parte porque custam ao catálogo e não ao banco.

Cabeçalhos

Toda resposta carrega os números, inclusive as permitidas, para que um cliente consiga desacelerar antes da parede em vez de depois.

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1788568502

X-RateLimit-Reset é um timestamp Unix ancorado na chamada mais antiga da janela, não em agora. Ele não foge para frente conforme você insiste, então dá para esperar uma vez em vez de recuar às cegas.

Acima do teto

{
  "error": {
    "code": "rate_limited",
    "message": "This key has used its allowance for now.",
    "retry_after": 118
  }
}

O outro teto

Publicar uma imagem é contado duas vezes: uma na cota write da chave, que conta requisições, e outra nas vinte imagens por hora da conta, que conta imagens. A segunda é a que aperta, porque imagem custa processamento e armazenamento, não uma linha.

As ações do Arcade têm limites próprios, por conta e por aplicativo, na tabela de limites do Arcade.

Escopos

O que cada permissão alcança, e as que faltam de propósito.

Erros

Um formato só, sempre, inclusive no 500.

Nesta página

CabeçalhosAcima do tetoO outro teto