Tvarkykite užklausų ribojimą ir serverio klaidas

Tvarkykite 429 atsakymą

Apribota užklausa grąžina 429 Too Many Requests, o detail.status yra rate_limit_exceeded. Prieš kartodami perskaitykite atsakymo antraštes:

• Retry-After nurodo mažiausią laukimo laiką sekundėmis atmestai užklausai.
• X-RateLimit-Limit rodo grupės ribą.
• X-RateLimit-Remaining rodo likusių užklausų skaičių.
• X-RateLimit-Reset nurodo, kada grupė bus atnaujinta.

Palaukite Retry-After nurodytą laiką ir kartokite su eksponentiniu delsos didinimu bei atsitiktine paklaida. Mažinkite lygiagrečių užklausų skaičių ir rikiuokite darbus, užuot siuntę jų pliūpsnį vos pasibaigus langui.

Tvarkykite serverio klaidas

500 atsakymo viešame turinyje pateikiama bendra klaida ir request_id; vidinės išimties detalės negrąžinamos. 503 gali reikšti, kad reikalinga paslauga laikinai nepasiekiama.

Tik skaitymo užklausas kartokite su ribotu delsos didinimu. Prieš kartodami kūrimo, atnaujinimo, mokėjimo ar kitą būseną keičiančią užklausą nustatykite, ar pirmasis bandymas įvyko. Laiko limitas ar 5xx atsakymas neįrodo, kad pakeitimas nepavyko; nedelsiant kartojant gali atsirasti dublikatų.

Išsaugokite diagnostiką

Užrašykite laiką, metodą, kelią, būseną, atsakymo turinį ir X-Request-Id. Niekada nerašykite x-api-key reikšmės į žurnalą. Po nedidelio riboto bandymų skaičiaus sustabdykite automatinį kartojimą ir perduokite klaidą peržiūrai.