Skip to main content
Dokumen ini menjelaskan kondisi pemicu dan solusi Batas laju YiDA Server API di DingTalk Open Platform.

Kondisi pemicu

Untuk mencegah beban abnormal pada server YiDA akibat kesalahan aplikasi, secara default setiap endpoint YiDA Server API memiliki Batas laju yang berbeda sesuai kompleksitasnya (untuk detailnya, Kirim tautan dokumen API kepada tim dukungan teknis). Melampaui salah satu dimensi batas tersebut akan memicu Batas laju. Kode Kesalahan Respons yang umum: failure.operation.requestTooFast, failure.operation.tooManyVisitors.
  • Batas QPS per Aplikasi: untuk setiap Aplikasi, Batas laju terpicu ketika Panggilan ke suatu endpoint melampaui frekuensi maksimum.
  • Batas QPS per Organisasi: untuk setiap Organisasi, Batas laju terpicu ketika Panggilan ke suatu endpoint melampaui frekuensi maksimum.
  • Batas QPS global per endpoint: karena kebijakan proteksi Keamanan endpoint YiDA, Jumlah panggilan per detik dibatasi. Kesalahan Respons akan terpicu ketika seluruh Aplikasi Organisasi YiDA secara bersama-sama memanggil suatu endpoint melebihi Jumlah panggilan per detik yang diizinkan.
Solusi
  • Umum: karena jendela Batas laju QPS adalah 1 detik, saat mengalami Kesalahan Batas laju, program dapat tidur selama 1 detik, lalu Lanjutkan eksekusi.
  • Strategi off-peak: untuk program yang memanggil YiDA API secara terjadwal, hindari waktu puncak tepat pada jam bulat, misalnya jadwalkan eksekusi 10 menit setelah jam bulat.

FAQ

J: Tidak, tidak akan dikenakan biaya ganda. Rinciannya sebagai berikut:Panggilan business API terkait YiDA terbagi menjadi 2 skenario penggunaan:
  1. YiDA bertindak sebagai Aplikasi SaaS dan memanggil endpoint DingTalk melalui fitur yang telah diproduksi (yaitu Connector resmi YiDA, misalnya mengambil Data absensi DingTalk). Panggilan ini tidak tunduk pada batasan kebijakan.
  2. Pelanggan telah membangun Aplikasi internal di DingTalk Open Platform dan langsung memanggil Konten dalam [daftar endpoint YiDA] dari sistem eksternal mereka sendiri (misalnya, sistem pelanggan memanggil endpoint openAPI YiDA untuk menyinkronkan Data Aplikasi yang dibangun di YiDA ke sistem pelanggan). Panggilan ini mengikuti kebijakan terpadu DingTalk Open Platform.
J: Tidak, tidak mengonsumsi Jumlah panggilan DingTalk Open Platform, karena Panggilan business API terkait YiDA tidak tunduk pada batasan kebijakan.
  1. Skenario 1: YiDA bertindak sebagai Aplikasi SaaS dan memanggil endpoint DingTalk melalui fitur yang telah diproduksi (yaitu Connector resmi YiDA, misalnya mengambil Data absensi DingTalk). Panggilan ini tidak tunduk pada batasan kebijakan.
J: Batas QPS yang dipublikasikan DingTalk Open Platform membedakan antara Aplikasi internal dan Aplikasi perusahaan pihak ketiga. YiDA, sebagai Aplikasi perusahaan pihak ketiga, juga tunduk pada batas QPS tersebut. Untuk setiap endpoint DingTalk yang dipanggil YiDA sendiri, frekuensi maksimumnya adalah 40 Panggilan/detik. Untuk detailnya, lihat Batas laju.
J: Karena Panggilan business API terkait YiDA tidak tunduk pada batasan kebijakan, Standar QPS tetap 40 Panggilan/detik sebagai frekuensi maksimum, terlepas dari edisi dasar DingTalk yang dibeli pelanggan YiDA.
  1. Skenario 1: YiDA bertindak sebagai Aplikasi SaaS dan memanggil endpoint DingTalk melalui fitur yang telah diproduksi (yaitu Connector resmi YiDA, misalnya mengambil Data absensi DingTalk). Panggilan ini tidak tunduk pada batasan kebijakan.
J: Selain Edisi Dedicated, saat ini pelanggan tidak dapat melakukan ekspansi kapasitas individual.