Apstrādājiet ātruma ierobežojumus un servera kļūdas

Apstrādājiet 429 atbildi

Kad pieprasījums pārsniedz ātruma ierobežojumu, API atgriež 429 Too Many Requests un detail.status vērtību rate_limit_exceeded. Pirms atkārtošanas izlasiet atbildes galvenes:

• Retry-After norāda minimālo gaidīšanas laiku sekundēs noraidītam pieprasījumam.
• X-RateLimit-Limit norāda kopas ierobežojumu.
• X-RateLimit-Remaining norāda atlikušos pieprasījumus.
• X-RateLimit-Reset norāda, kad kopa tiek atiestatīta.

Nogaidiet Retry-After, pēc tam atkārtojiet pieprasījumu ar eksponenciālu gaidīšanas palielināšanu un nejaušu nobīdi. Samaziniet paralēlo pieprasījumu skaitu un veidojiet rindu, nevis sūtiet pieprasījumu vilni uzreiz pēc loga atiestates.

Apstrādājiet servera kļūdas

500 atbildes publiskajā saturā ir vispārīga kļūda un request_id; iekšējās izņēmuma detaļas netiek atgrieztas. 503 var nozīmēt, ka nepieciešamais pakalpojums īslaicīgi nav pieejams.

Atkārtojiet tikai lasīšanas pieprasījumus ar ierobežotu gaidīšanas palielinājumu. Pirms atkārtoti sūtāt izveides, atjaunināšanas, maksājuma vai citu stāvokli mainošu pieprasījumu, noskaidrojiet, vai pirmais mēģinājums tika pabeigts. Noildze vai 5xx atbilde nepierāda, ka izmaiņa neizdevās, un tūlītēja atkārtošana var radīt dublikātus.

Saglabājiet diagnostikas datus

Pierakstiet laiku, metodi, ceļu, statusu, atbildes saturu un X-Request-Id. Nekad nereģistrējiet x-api-key vērtību. Pēc neliela, ierobežota mēģinājumu skaita pārtrauciet automātisku atkārtošanu un nododiet kļūdu pārskatīšanai.