Error dan percobaan ulang
Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris
Setiap kegagalan yang dilempar pustaka adalah salah satu dari empat error, dan keempatnya berbagi tipe dasar yang sama, sehingga satu handler dapat menangkap semuanya.
- Error API. API menolak permintaan. Error ini membawa status HTTP,
codeyang stabil untuk percabangan, dan pesan dalam bahasa yang Anda minta. - Error OAuth. Endpoint token menolak kredensial Anda atau scope yang Anda minta.
- Error pemeliharaan. API sedang tidak tersedia sebentar karena pemeliharaan.
- Error transport. Tidak ada jawaban yang bisa dipakai: koneksi gagal atau habis waktu, atau respons tidak dapat dibaca.
Membatalkan panggilan bukanlah error. Pembatalan muncul sebagai mekanisme pembatalan milik bahasa Anda sendiri.
Apa yang diulang
429 atau 503 yang menyebutkan berapa lama harus menunggu, dalam header Retry-After sebesar 60 detik atau kurang, diulang setelah menunggu tepat selama itu. Satu panggilan melakukan paling banyak 3 percobaan. Anda dapat mematikan percobaan ulang dengan mengatur batas maksimum ke 1.
Semua yang lain langsung dilempar:
- 429 atau 503 tanpa
Retry-After; - waktu tunggu lebih dari 60 detik, yang tidak akan dihabiskan pustaka di dalam panggilan Anda. Error-nya membawa
retry_after, sehingga Anda bisa menjadwalkan percobaan ulang sendiri; - error transport, karena permintaan mungkin sudah sampai ke API;
- stream apa pun yang sudah mengirimkan sebuah event.