Käsitle päringupiiranguid ja serverivigu

Käsitle 429 vastust

Piiratud päring saab vastuse 429 Too Many Requests, mille detail.status on rate_limit_exceeded. Loe enne kordamist vastuse päiseid:

• Retry-After määrab minimaalse ooteaja sekundites.
• X-RateLimit-Limit näitab kogumi piiri.
• X-RateLimit-Remaining näitab alles jäänud päringuid.
• X-RateLimit-Reset näitab kogumi lähtestamise aega.

Oota Retry-After järgi ja korda päringut eksponentsiaalse taganemise ning juhusliku viivitusega. Vähenda samaaegseid päringuid ja pane töö järjekorda, selle asemel et akna lähtestamisel korraga suur hulk päringuid saata.

Käsitle serverivigu

500 vastuse avalik sisu sisaldab üldist viga ja request_id, kuid mitte sisemisi erandi üksikasju. 503 võib tähendada, et vajalik teenus on ajutiselt kättesaamatu.

Korda ainult lugemiseks mõeldud päringuid piiratud viivitusega. Enne loomise, muutmise, makse või muu olekut muutva päringu kordamist tee kindlaks, kas esimene katse jõudis lõpule. Ajalõpp või 5xx ei tõesta muudatuse ebaõnnestumist; kohene kordus võib toimingu dubleerida.

Säilita diagnostika

Märgi üles ajatempel, meetod, tee, olek, vastuse sisu ja X-Request-Id. Ära logi kunagi x-api-key väärtust. Lõpeta automaatsed kordused pärast väikest piiratud arvu katseid ja esita viga ülevaatamiseks.