Erros comuns
Esta página é composta pela distribuição de status por endpoint nos últimos 30 dias. Onde não medimos alguma coisa, está assim indicado.
Erros de caminho
Seção intitulada “Erros de caminho”Os 4xx mais frequentes no log são 404, e quase todos não são seus: são scanners que tentam .env, .git/config, wordpress/, wp-content/…. Os erros de caminho reais dos integradores são outros, e já estão descritos com exemplos aqui: Chamadas inválidas que vemos mais frequentemente. Resumindo: /api/… em vez de /v1/…, duplicado /v1/v1/…, /swagger.json em vez de /v1/openapi.json.
402: o plano não inclui o endpoint
Seção intitulada “402: o plano não inclui o endpoint”385 respostas em 30 dias. A distribuição mostra para onde o plano gratuito mais frequentemente atinge o limite:
| Endpoint | 402 em 30 dias |
|---|---|
chart | 114 |
transit-calendar | 101 |
vedic/dashas/vimshottari/maha | 48 |
ingresses | 25 |
planetary-hours | 24 |
vedic/panchang/full | 24 |
eclipses | 13 |
No corpo da resposta vem current_plan e upgrade_to. Isto não é um erro de pedido: o corpo está correto, a chave é válida, simplesmente o plano não inclui este endpoint.
429: dois limites diferentes
Seção intitulada “429: dois limites diferentes”6 791 respostas em 30 dias, sendo 3 769 sem chave e 3 022 com chave. São dois mecanismos diferentes, e não devem ser confundidos:
- sem chave o limite é calculado por IP, 30 pedidos por hora. O maior bloco no nosso log nem são integradores, mas sim auditorias sintéticas do Chrome-Lighthouse de 15 endereços;
- com chave o limite é o RPM do seu plano. Na resposta há
Retry-Afterem segundos, e precisamente ele que deve ser esperado, e não tentar novamente imediatamente.
400: quase sempre corpo do pedido de cartão
Seção intitulada “400: quase sempre corpo do pedido de cartão”700 respostas em 30 dias, e estão concentradas nos endpoints que aceitam data, hora e coordenadas: chart (111), horoscope/daily (19), transits (18), synastry (15), rectification (15).
O mais caro destes erros nem é o que dá 400, mas o que antes dava 200: escritas abreviadas dos campos. Regras e exemplo de resposta: Formatos de campos.
401 e 403
Seção intitulada “401 e 403”401 é a chave ausente ou inválida; a mensagem menciona ambas as classes, aw_ e pk_. 403 é a origem: a chave de navegador pk_ é rejeitada se o pedido vier sem origem ou de um domínio estranho, e a chave com scope de endpoint responde ENDPOINT_NOT_IN_SCOPE e lista o seu scope em details.
Tabela completa de códigos: Erros.