Pułapki
Nic z tego nie jest błędem. To zachowanie, o którym lepiej dowiedzieć się z dokumentacji, niż z analizy cudzej odpowiedzi.
W odpowiedzi jest dodatkowe pole _footer
Dział zatytułowany „W odpowiedzi jest dodatkowe pole _footer”Bezpłatny plan i każde wywołanie bez klucza otrzymują w treści dodatkowe pole _footer z podpisem. Klucze płatne go nie widzą. Jeśli Twój parser jest ścisły co do dodatkowych pól, to o tym pierwszy się potknie.
Powtórzone identyczne wywołanie kosztuje zero
Dział zatytułowany „Powtórzone identyczne wywołanie kosztuje zero”Identyczne żądanie w oknie cache zwraca X-Cache: HIT, a takie wywołanie nie zużywa kredytów: w odpowiedzi X-Credits-Used: 0, a reszta jest zwracana. Oznacza to, że nie można zmierzyć kosztu, wysyłając to samo żądanie wielokrotnie: płacisz raz.
Klucz testowy nie zużywa niczego
Dział zatytułowany „Klucz testowy nie zużywa niczego”aw_test_* nie zużywa w ogóle kredytów i nie wchodzi do limitu konta. To nie jest “mała kwota”, to zero. Powinieneś rozwijać aplikację właśnie na nim, a aw_live_* brać wtedy, gdy sprawdzasz rozliczenia.
Nieznane pola są ignorowane
Dział zatytułowany „Nieznane pola są ignorowane”Treść akceptuje dodatkowe klucze i je ignoruje. Wyjątkiem są tylko wyraźnie odrzucone skrócone zapisy (lat, tz i resztę, zobacz Formaty pól). Dlatego literówka w nazwie pola zwykle nie da o sobie znać: otrzymasz 200 i wykres obliczony bez Twojego parametru.
Na biegunach system domów jest zastępowany
Dział zatytułowany „Na biegunach system domów jest zastępowany”Dla systemów kwadrantowych przy |latitude| > 66.5° Swiss Ephemeris cicho zwraca Porphyry. Nie ukrywamy tego: w odpowiedzi pojawia się pole warning. Whole Sign i Equal działają na każdej szerokości geograficznej.
Sąsiedni przypadek zamknęliśmy odrzuceniem: nieznany kod houseSystem już nie daje Placidusa pod inną nazwą, ale zwraca 400.
Klucz ma trzy niezależne limity
Dział zatytułowany „Klucz ma trzy niezależne limity”Klucz przeglądarkowy pk_ i tajny aw_ mogą nieść trzy ograniczenia jednocześnie, i się nie wykluczają:
| Limit | Co mówi | Odrzucenie |
|---|---|---|
| lista domen | skąd można go wywołać | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | ile ten klucz może wydać | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | co dokładnie można wywołać | 403 ENDPOINT_NOT_IN_SCOPE |
Zakres endpointów nie zwalnia z odczytów usługowych: klucz zawężony do embed/* nie odczyta nawet własnej statystyki. Jest to celowe, szczegóły w Autentykacji.
Edycja kluczu obowiązuje od następnego żądania
Dział zatytułowany „Edycja kluczu obowiązuje od następnego żądania”Klucze są cache’owane przez 60 sekund, ale każda zmiana przez PATCH /v1/keys/{id} resetuje cache natychmiast. Nie trzeba czekać minuty.