Підводні камені
Нічого з цього не є помилкою. Це поведінка, про яку краще дізнатися з документації, ніж із розбору чужої відповіді.
У відповіді є зайве поле _footer
Section titled “У відповіді є зайве поле _footer”Безкоштовний тариф і будь-який виклик без ключа отримують у тілі додаткове поле _footer з підписом. Платні ключі його не бачать. Якщо ваш парсер сувора до зайвих полів, це перше, на чому він спіткнеться.
Повторний однаковий виклик коштує нуль
Section titled “Повторний однаковий виклик коштує нуль”Ідентичний запит протягом вікна кешу повертає X-Cache: HIT, і такий виклик не списує кредитів: у відповіді X-Credits-Used: 0, а залишок повертається назад. Тобто виміряти вартість, ганяючи один і той самий запит, не вийде: заплатите один раз.
Sandbox-ключ не витрачає нічого
Section titled “Sandbox-ключ не витрачає нічого”aw_test_* не списує кредитів взагалі й не входить у ліміт акаунта. Це не «маленька квота», це нуль. Розробляти варто саме на ньому, а aw_live_* брати тоді, коли перевіряєте білінг.
Незнайомі поля проходять мовчки
Section titled “Незнайомі поля проходять мовчки”Тіло приймає зайві ключі й ігнорує їх. Виняток лише для явно відхилених коротких написань (lat, tz і решта, див. Формати полів). Тому одруківка в назві поля зазвичай не дасть про себе знати: ви отримаєте 200 і карту, порахувану без вашого параметра.
За полярним колом система домів підміняється
Section titled “За полярним колом система домів підміняється”Для квадрантних систем при |latitude| > 66.5° Swiss Ephemeris мовчки віддає Porphyry. Ми це не приховуємо: у відповіді з’являється поле warning. Whole Sign і Equal працюють на будь-якій широті.
Сусідній випадок ми закрили відмовою: невідомий код houseSystem більше не дає Placidus під чужою назвою, а повертає 400.
Ключ має три незалежні межі
Section titled “Ключ має три незалежні межі”Браузерний ключ pk_ і секретний aw_ можуть нести три обмеження одразу, і вони не замінюють одне одного:
| Межа | Що каже | Відмова |
|---|---|---|
| список доменів | звідки можна викликати | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | скільки цей ключ може витратити | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | що саме можна викликати | 403 ENDPOINT_NOT_IN_SCOPE |
Область ендпоінтів не звільняє службові читання: ключ, звужений до embed/*, не прочитає й власну статистику. Це навмисно, подробиці в Автентифікації.
Правка ключа діє з наступного запиту
Section titled “Правка ключа діє з наступного запиту”Ключі кешуються на 60 секунд, але будь-яка зміна через PATCH /v1/keys/{id} скидає кеш одразу. Чекати хвилину не треба.