Rejtett buktatók
Ebből semmi sem hiba. Ez a viselkedés, amiről jobb a dokumentációból megtudni, mint egy másik válasz elemzéséből.
A válaszban van egy felesleges mező _footer
Szekció neve “A válaszban van egy felesleges mező _footer”Az ingyenes tarif és bármely kulcs nélküli hívás a választestben egy extra _footer mezőt kap aláírással. A fizetett kulcsok ezt nem látják. Ha a parsered szigorú a felesleges mezőkkel szemben, ez az első dolog, amire beleütközik.
Az ismételt azonos hívás nulla költségű
Szekció neve “Az ismételt azonos hívás nulla költségű”Az azonos kérés a gyorsítótárablak alatt X-Cache: HIT-et ad vissza, és ez a hívás nem von le krediteket: a válaszban X-Credits-Used: 0, és a maradék visszatér. Vagyis a költséget nem lehet mérni ugyanazt a kérést újra és újra futtatva: egyszer fizetsz.
A Sandbox-kulcs semmit sem fogyaszt
Szekció neve “A Sandbox-kulcs semmit sem fogyaszt”aw_test_* egyáltalán nem von le krediteket és nem számít bele a fiók limitjébe. Ez nem „kis kvóta”, ez nulla. Fejleszteni érdemes kifejezetten ezen, és aw_live_*-t akkor használni, amikor a számlázást ellenőrzöd.
Az ismeretlen mezők csendben átmennek
Szekció neve “Az ismeretlen mezők csendben átmennek”A választest elfogadja a felesleges kulcsokat és figyelmen kívül hagyja őket. Kivétel csak a kifejezetten elutasított rövid írásokra (lat, tz és a többi, lásd Mezőformátumok). Így egy elütés a mező nevében általában nem fog feltűnni: 200-at kapsz és egy térképet, ami a te paramétered nélkül lett kiszámítva.
A sarki kör felett a házrendszer lecserélődik
Szekció neve “A sarki kör felett a házrendszer lecserélődik”A kvadráns rendszerek esetén |latitude| > 66.5° a Swiss Ephemeris csendben Porphyry-t ad vissza. Ezt nem rejtegetjük: a válaszban megjelenik a warning mező. A Whole Sign és az Equal bármilyen szélességen működik.
A szomszédos esetet elutasítással zártuk le: egy ismeretlen houseSystem kód már nem ad Placidus-t más néven, hanem 400-at ad vissza.
A kulcsnak három független határa van
Szekció neve “A kulcsnak három független határa van”A böngésző kulcs pk_ és a titkos aw_ egyszerre három korlátozást hordozhat, és nem helyettesítik egymást:
| Határ | Mit mond | Elutasítás |
|---|---|---|
| domain lista | honnan lehet hívni | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | mennyit költhet ez a kulcs | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | pontosan mit lehet hívni | 403 ENDPOINT_NOT_IN_SCOPE |
Az endpoint terület nem szabadítja fel a szolgálati olvasásokat: egy embed/*-ra szűkített kulcs nem fogja elolvasni a saját statisztikádat sem. Ez szándékos, részletek a Hitelesítés.
A kulcs módosítása a következő kérésnél lép életbe
Szekció neve “A kulcs módosítása a következő kérésnél lép életbe”A kulcsok 60 másodpercre vannak cache-elve, de bármilyen változtatás a PATCH /v1/keys/{id}-en keresztül azonnal törli a cache-t. Nem kell egy percet várni.