Ralat dan cubaan semula
Halaman ini diterjemahkan daripada bahasa Inggeris. Jika kedua-duanya berbeza, halaman bahasa Inggeris adalah yang betul. Baca halaman bahasa Inggeris
Setiap kegagalan yang dilontarkan oleh pustaka ialah salah satu daripada empat ralat, dan keempat-empatnya berkongsi jenis asas, jadi satu pengendali boleh menangkap kesemuanya.
- Ralat API. API menolak permintaan. Ia membawa status HTTP,
codeyang stabil untuk dijadikan cabang, dan mesej dalam bahasa yang anda minta. - Ralat OAuth. Endpoint token menolak kelayakan anda atau skop yang anda minta.
- Ralat penyelenggaraan. API tidak tersedia buat seketika kerana penyelenggaraan.
- Ralat pengangkutan. Tiada jawapan yang boleh digunakan tiba: sambungan gagal atau tamat masa, atau respons tidak dapat dibaca.
Membatalkan panggilan bukan ralat. Ia muncul sebagai mekanisme pembatalan bahasa anda sendiri.
Apa yang dicuba semula
429 atau 503 yang menyatakan berapa lama perlu menunggu, dalam pengepala Retry-After sebanyak 60 saat atau kurang, dicuba semula selepas menunggu tepat selama itu. Satu panggilan membuat paling banyak 3 cubaan. Anda boleh mematikan cubaan semula dengan menetapkan maksimum kepada 1.
Semua yang lain dilontarkan serta-merta:
- 429 atau 503 tanpa
Retry-After; - tempoh menunggu lebih daripada 60 saat, yang tidak akan dihabiskan oleh pustaka di dalam panggilan anda. Ralat itu membawa
retry_after, jadi anda boleh menjadualkan cubaan semula sendiri; - ralat pengangkutan, kerana permintaan itu mungkin sudah sampai ke API;
- mana-mana strim yang telah menghantar sesuatu peristiwa.