Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Limites de taxa da API Graph do Facebook: erros 4, 17, 32, 613 e 80001

A API Graph do Facebook concede a um token de Página ou de utilizador de sistema 4,800 chamadas à API de Páginas por utilizador que interagiu, numa janela móvel de 24 horas. Ao ultrapassar um limite, devolve 4, Application request limit reached; 17, User request limit reached; 32, Page request limit reached; 613, Calls to this api have exceeded the rate limit; ou 80001, There have been too many calls to this Page account. Pare de fazer chamadas e retome gradualmente.

A easyCoexistence chama cada Página ligada com o token próprio da Página e recebe a sua atividade do feed, as menções e as mensagens através dos webhooks da Meta, encaminhando-as para o seu endpoint se o desejar, pelo que nada precisa de consultar a Página.

4

Código devolvido quando a aplicação cujo token é utilizado no pedido atingiu o seu limite de taxa.

17

Código devolvido quando o utilizador cujo token é utilizado no pedido atingiu o seu limite de taxa.

32

Código devolvido quando o utilizador ou a aplicação cujo token é utilizado num pedido à API de Páginas atingiu o seu limite de taxa.

613

Código para um limite de taxa personalizado; com o subcódigo 1996, a Meta detetou um comportamento inconsistente no volume de pedidos da aplicação.

80001

Código do caso de utilização empresarial (Business Use Case) para chamadas a Páginas feitas com um token de acesso de Página ou de utilizador de sistema.

4,800 × engaged users

Chamadas à API de Páginas permitidas numa janela móvel de 24 horas com um token de Página ou de utilizador de sistema.

Qual é o significado de cada código de limite de taxa?

Cada código indica o limite que foi atingido, e o token no pedido determina qual se aplica. O guia de limites de taxa da Meta explica o que cada código indica, e as suas referências de erros dão a mensagem que o acompanha. Aqui estão lado a lado, com a mensagem tal como a Meta a escreve:

Meta's messageWhat reached its limit
4Application request limit reachedThe app whose token made the request
17User request limit reachedThe user whose token made the request
32(#32) Page request limit reachedThe user or app token used in a Pages API request
613(#613) Calls to this api have exceeded the rate limit.A custom limit set by the API being called
80001(#80001) There have been too many calls to this Page account. Wait a bit and try again.Calls made on that Page with a Page or system user token

Que limite se aplica a uma Página?

Depende do token. A Meta diz que os limites de Páginas podem seguir a lógica da Plataforma ou a do Business Use Case, consoante o tipo de token utilizado. As chamadas à API de Páginas feitas com um token de Página ou de utilizador de sistema seguem o limite Business Use Case para Páginas, enquanto as chamadas feitas com um token de utilizador ou de aplicação ficam sujeitas aos limites de Plataforma do utilizador ou da aplicação. Quando ambos podem aplicar-se a um pedido, a Meta aplica o limite Business Use Case.

Qual é a dimensão dos limites?

A Meta publica fórmulas em vez de números fixos, pelo que cada limite cresce com a utilização:

  • Aplicações: 200 chamadas por hora por cada utilizador ativo diário, contadas no conjunto das chamadas da aplicação e não por utilizador.
  • Páginas, com um token de Página ou de utilizador de sistema: 4,800 chamadas numa janela móvel de 24 horas por cada utilizador que interagiu com a Página nessas 24 horas.
  • API Send do Messenger: 300 chamadas por segundo por Página para texto, ligações, reações e autocolantes, e 10 para áudio ou vídeo.
  • As chamadas do Messenger também têm um tipo próprio de Business Use Case, indicado como erro 80006.

Como se percebe que um limite se aproxima?

Leia os cabeçalhos de utilização. Os endpoints que recebem pedidos suficientes de uma aplicação incluem X-App-Usage, cujos call_count, total_cputime e total_time são percentagens dos limites de Plataforma da aplicação. As respostas limitadas segundo a lógica Business Use Case incluem em vez disso X-Business-Use-Case-Usage, com as mesmas percentagens para cada objeto de negócio, o tipo de limite, como pages, e estimated_time_to_regain_access.

The two usage headers (Meta's sample X-App-Usage values; illustrative values for the Page)
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}

X-Business-Use-Case-Usage: {
  "{business-object-id}": [
    {
      "type": "pages",
      "call_count": 100,
      "total_cputime": 34,
      "total_time": 41,
      "estimated_time_to_regain_access": 12
    }
  ]
}

Quanto tempo se espera?

Até que a utilização desça, o que os cabeçalhos mostram. Para um limite Business Use Case como o 80001, estimated_time_to_regain_access indica os minutos até as chamadas deixarem de ser limitadas. Para os limites de Plataforma, o call_count da aplicação abrange um período móvel de uma hora, pelo que desce à medida que as chamadas mais antigas saem da contagem. A orientação da Meta é a mesma para ambos: pare de fazer chamadas assim que um limite for atingido, porque continuar a chamar aumenta a contagem de chamadas e o tempo até que voltem a ter êxito.

Como se mantém abaixo dos limites?

Faça menos chamadas, mais leves, e distribua-as no tempo. As boas práticas da Meta são distribuir as consultas de forma uniforme para evitar picos de tráfego, usar filtros para limitar o tamanho das respostas e evitar chamadas que pedem dados sobrepostos e, quando os utilizadores estão a ser limitados, certificar-se de que a aplicação não é a causa. Os webhooks também ajudam: a Meta entrega a atividade do feed e as mensagens de uma Página à medida que acontecem, pelo que a aplicação não precisa de gastar chamadas a procurá-las.

Erros comuns

  • Tentar de imediato. A Meta avisa que continuar a fazer chamadas aumenta a contagem de chamadas e o tempo até que voltem a ter êxito.
  • Tratar todos os códigos da mesma forma. O 4 é o limite da aplicação, o 17 é o de um utilizador e o 80001 é o de uma Página, pelo que abrandar o chamador errado não altera nada.
  • Ler o X-App-Usage em chamadas feitas com um token de Página. Estas contam para o limite Business Use Case e são reportadas em X-Business-Use-Case-Usage.
  • Consultar com frequência uma Página pouco ativa. A sua quota escala com os utilizadores que interagiram com ela, pelo que uma Página com pouca interação tem menos chamadas para gastar.
Fazer isto com a EasyCoexistence

Quando a Meta limita uma chamada, a ferramenta devolve o código e a mensagem da Meta ao Claude, ao ChatGPT ou ao seu próprio código, para que a sua IA possa esperar antes de voltar a tentar, e uma publicação que a Meta limite é repetida automaticamente após 5 minutos, 30 minutos e 2 horas. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O que significa Application request limit reached?

É o erro 4: a aplicação cujo token fez a chamada atingiu o seu limite de taxa. Pare de fazer chamadas e retome gradualmente, à medida que a utilização da aplicação desce.

Qual a diferença entre o erro 32 e o erro 80001?

O token. O erro 32 é o limite de Plataforma de um token de utilizador ou de aplicação que chama a API de Páginas; o 80001 é o limite por Página para chamadas feitas com um token de Página ou de utilizador de sistema.

Quanto tempo dura um limite de taxa do Facebook?

A Meta não define um tempo fixo. No caso do 80001, o cabeçalho X-Business-Use-Case-Usage indica os minutos até as chamadas deixarem de ser limitadas; a utilização de uma aplicação é medida numa hora móvel.

O que significa o erro 613?

Um limite de taxa personalizado, definido pela API chamada. Com o subcódigo 1996, a Meta detetou um comportamento inconsistente no volume de pedidos da aplicação, por exemplo após uma alteração recente no número de pedidos que envia.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em