Armadilhas

Nada disto é um erro. É um comportamento que é melhor aprender da documentação do que da análise de uma resposta alheia.

Na resposta há um campo extra _footer

O plano gratuito e qualquer chamada sem chave recebem no corpo um campo extra _footer com assinatura. Chaves pagas não o veem. Se o seu parser é rigoroso quanto a campos extras, este será o primeiro em que ele tropeça.

Uma chamada idêntica repetida custa zero

Um pedido idêntico dentro da janela de cache retorna X-Cache: HIT, e tal chamada não deduz créditos: na resposta X-Credits-Used: 0, e o saldo é devolvido. Portanto, não é possível medir o custo, batendo o mesmo pedido repetidamente: você pagará uma vez.

Chave Sandbox não gasta nada

aw_test_* não deduz créditos de todo e não entram no limite da conta. Não é uma “cota pequena”, é zero. O desenvolvimento deve ser feito nele, e aw_live_* deve ser usado quando verificar a faturação.

Campos desconhecidos são ignorados silenciosamente

O corpo aceita chaves extras e as ignora. A exceção são as notações curtas explicitamente rejeitadas (lat, tz e as restantes, ver Formatos de Campo). Portanto, um erro de digitação no nome de um campo geralmente não se manifestará: você receberá 200 e um gráfico calculado sem o seu parâmetro.

Cuidado

O pior caso deste tipo: city parece um endereço, mas não geocodifica nada. Sem latitude e longitude não haverá gráfico.

Acima do Círculo Polar, o sistema de casas é substituído

Para sistemas de quadrante com |latitude| > 66.5°, o Swiss Ephemeris retorna silenciosamente Porphyry. Isto não é oculto: um campo warning aparece na resposta. Whole Sign e Equal funcionam em qualquer latitude.

Um caso similar fechámos com rejeição: códigos houseSystem desconhecidos já não dão Placidus sob outro nome, mas retornam 400.

A chave tem três limites independentes

A chave do navegador pk_ e a secreta aw_ podem ter três restrições ao mesmo tempo, e elas não se substituem:

Limite	O que diz	Recusa
lista de domínios	de onde pode ser chamado	403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED
credits_cap_cycle	quanto esta chave pode gastar	429 KEY_BUDGET_EXHAUSTED
allowed_endpoints	o que exatamente pode ser chamado	403 ENDPOINT_NOT_IN_SCOPE

O âmbito de endpoint não liberta leituras de serviço: uma chave restrita a embed/* não lerá as suas próprias estatísticas. É intencional, detalhes em Autenticação.

A alteração da chave entra em vigor a partir do próximo pedido

As chaves são cacheadas por 60 segundos, mas qualquer alteração via PATCH /v1/keys/{id} limpa o cache imediatamente. Não é necessário esperar um minuto.