Kendalikan had kadar dan ralat server

Kendalikan respons 429

Permintaan yang dihadkan memulangkan 429 Too Many Requests dengan detail.status bernilai rate_limit_exceeded. Baca pengepala respons sebelum mencuba lagi:

• Retry-After memberikan tempoh menunggu minimum dalam saat.
• X-RateLimit-Limit melaporkan had kelompok.
• X-RateLimit-Remaining melaporkan permintaan berbaki.
• X-RateLimit-Reset melaporkan masa kelompok ditetapkan semula.

Tunggu menurut Retry-After, kemudian cuba semula menggunakan sela masa meningkat secara eksponen dan sedikit rawak. Kurangkan permintaan serentak dan gunakan baris gilir, bukannya menghantar banyak permintaan sebaik tetingkap ditetapkan semula.

Kendalikan ralat server

Untuk 500, badan respons awam mengandungi ralat umum dan request_id, bukan butiran pengecualian dalaman. 503 boleh menunjukkan perkhidmatan yang diperlukan tidak tersedia buat sementara waktu.

Cuba semula permintaan baca sahaja dengan sela masa terhad. Sebelum mengulang permintaan mencipta, mengemas kini, membayar atau mengubah keadaan lain, tentukan sama ada percubaan pertama telah selesai. Timeout atau 5xx tidak membuktikan perubahan gagal; ulangan segera boleh menggandakan kerja.

Simpan diagnostik

Rekod cap masa, kaedah, laluan, status, badan respons dan X-Request-Id. Jangan log nilai x-api-key. Hentikan percubaan automatik selepas beberapa kali yang dihadkan dan tampilkan kegagalan untuk disemak.