Pedoman untuk pembatasan laju API Blue
Secara umum, API Blue tidak memberlakukan batas laju yang ketat pada sebagian besar operasi. Namun, beberapa operasi sensitif memiliki batas laju tertentu untuk mencegah penyalahgunaan dan memastikan stabilitas sistem.
Operasi yang Dibatasi Laju
Operasi berikut memiliki batas laju yang diberlakukan:
Operasi | Batas Laju | Jendela | Tujuan |
---|---|---|---|
signIn |
5 requests | 60 seconds | Mencegah serangan brute force |
signInRequest |
3 requests | 120 seconds | Membatasi upaya otentikasi |
createDocument |
5 requests | 60 seconds | Mencegah spam dokumen |
sendTestEmail |
5 requests | 60 seconds | Mencegah penyalahgunaan email |
submitForm |
5 requests | 60 seconds | Mencegah spam formulir |
exportTodos |
1 request | 50 seconds | Membatasi ekspor yang memakan sumber daya |
deleteCompany |
3 requests | 60 seconds | Mencegah penghapusan yang tidak disengaja |
deleteCompanyRequest |
3 requests | 60 seconds | Mencegah penghapusan yang tidak disengaja |
updateEmail |
3 requests | 60 seconds | Mencegah penyalahgunaan perubahan email |
updateEmailRequest |
3 requests | 60 seconds | Mencegah penyalahgunaan perubahan email |
verifyAcceptInvitation |
3 requests | 60 seconds | Membatasi upaya verifikasi |
verifySecurityCode |
3 requests | 60 seconds | Membatasi upaya verifikasi |
Perilaku Batas Laju
- Per Pengguna: Batas laju diterapkan per pengguna yang terautentikasi
- Per IP: Untuk permintaan yang tidak terautentikasi, batas diterapkan per alamat IP
- Tanpa Header: Informasi batas laju tidak disertakan dalam header respons
Respons Kesalahan
Ketika batas laju terlampaui, Anda akan menerima kesalahan GraphQL:
{
"errors": [{
"message": "Rate limit exceeded",
"extensions": {
"code": "RATE_LIMITED"
}
}]
}
Praktik Terbaik
- Tangani Kesalahan Batas Laju: Terapkan penanganan kesalahan yang tepat untuk operasi yang dibatasi laju
- Backoff Eksponensial: Gunakan backoff eksponensial saat mencoba kembali permintaan yang dibatasi laju
- Pantau Penggunaan: Ketahui operasi mana yang memiliki batas saat membangun integrasi
Untuk pertanyaan tentang batas laju, silakan hubungi tim dukungan kami.