- 1xx: Informacional - comunica informações no nível do protocolo de transferência.
- 2xx: Sucesso - a requisição foi bem-sucedida.
- 3xx: Redirecionamento - o cliente deve tomar alguma ação adicional para concluir a requisição.
- 4xx: Erro do cliente - requisição falhou devido a erro do cliente.
- 5xx: Erro do servidor - requisição falhou devido a erro do servidor.
200 Success
Uma requisição bem-sucedida foi feita.400 Bad Request
Um erro400 Bad Request significa que o servidor não conseguiu prosseguir com a requisição. A causa mais comum do erro é sintaxe ruim na URL ou no corpo da requisição.
401 Unauthorized
Os erros401 Unauthorized geralmente são causados por um problema no header da requisição da sua chamada de API, ou seja, você não usou uma API Key válida para fazer a chamada.
403 Access Denied
Quando sua aplicação faz uma chamada de API com sua API Key e a requisição não é permitida. Um 403 também pode ser retornado se o User Profile estiver suspenso.404 Resource Not Found
Esse erro ocorre quando sua aplicação tenta chamar uma API ou buscar uma entidade que não existe.405 Method Not Allowed
Esse erro indica que os métodos do protocolo HTTP na sua requisição não são suportados. Verifique a documentação da API para ver os métodos suportados.429 Rate Limit
Limites de taxa por User Profile
Cada User Profile tem um limite de taxa de 300 requisições de API por intervalo de 5 minutos. Você pode monitorar o uso do seu limite de taxa pelos headers de resposta:x-ratelimit-max: mostra o máximo permitido de requisições por período de 5 minutosx-ratelimit-count: exibe quantas requisições você fez no período de 5 minutos atual
Recomendamos verificar respostas com código de erro 429. Se você vir um erro 429, atingiu seu limite
de taxa. Tentativas repetidas de exceder o limite de taxa podem resultar na suspensão do User Profile.Saiba mais sobre como lidar com limites de taxa para vários User Profiles.
Limites de taxa de análises por plataforma
HTTP429 também pode ser retornado quando uma rede social limita chamadas de análises para uma conta específica — independentemente dos limites do seu User Profile no Ayrshare. Nesse caso, a resposta traz um código de erro específico da plataforma no Ayrshare (por exemplo, code: 444 para throttles de análises por Página do Facebook). Inspecione o campo code para distinguir um limite de taxa de profile de um throttle do lado da plataforma e tente novamente com backoff em vez de orientar o usuário a revincular.
Limites de taxa para exclusão de User Profile
Você pode excluir 8 User Profiles por segundo. Escalone as chamadas de API se precisar fazer exclusões em massa.Proteção de limite de taxa e política de suspensão
Para proteger a integridade do nosso sistema, implementamos suspensão automática caso um User Profile exceda os limites de taxa com frequência excessiva. Veja como funciona: Ao fazer requisições de API, você deve gerenciar cuidadosamente a janela de 5 minutos. Por exemplo, se você fizer 300 requisições em um minuto, precisará esperar mais quatro minutos antes de fazer requisições adicionais. Quaisquer requisições nesse período de espera acionarão uma resposta de erro429.
Se um User Profile acumular 1.000 violações de limite de taxa (erros 429) em um período de 24 horas, o profile será suspenso automaticamente.
Depois que um período de espera de 5 minutos expirar, você poderá retomar as requisições até o limite padrão de 300 por janela de 5 minutos.
500 Internal Server Error
Um500 Internal Server Error indica que o Ayrshare está passando por um erro interno ou que o processamento falhou.