Batas Laju

Batas laju adalah jumlah panggilan API yang dapat dilakukan oleh aplikasi dalam periode waktu tertentu. Jika batas ini dilampaui atau jika CPU atau batas waktu total dilampaui, aplikasi atau pengguna akan terhambat. Permintaan API yang dibuat oleh pengguna atau aplikasi yang terhambat akan gagal.

Semua permintaan API dikenai batas laju. Permintaan Graph API dan API Tampilan Dasar Instagram dikenai Batas Laju Platform, sedangkan permintaan Marketing API dan Platform Instagram dikenai Batas Laju Kasus Penggunaan Bisnis (BUC).

Permintaan Pages API tunduk pada Batas Tarif Platform atau BUC, bergantung pada token yang digunakan dalam permintaan; permintaan yang dibuat dengan aplikasi atau token akses pengguna tunduk pada Batas Laju Platform, sedangkan permintaan yang dibuat dengan pengguna sistem atau token akses halaman tunduk pada Batas Laju Kasus Penggunaan Bisnis.

Statistik penggunaan batas laju real-time dijelaskan di header yang disertakan dengan sebagian besar tanggapan API setelah cukup banyak panggilan dilakukan ke endpoint. Statistik Batas Laju Platform juga ditampilkan di Dasbor Aplikasi. Setelah batas laju tercapai, permintaan selanjutnya yang dilakukan oleh aplikasi akan gagal dan API akan mengembalikan kode kesalahan hingga cukup banyak waktu berlalu sehingga jumlah panggilan jatuh di bawah batas.

Jika batas laju Platform dan Kasus Penggunaan Bisnis dapat diterapkan ke permintaan, batas laju BUC akan diterapkan.

Batas Laju Platform

Batas Laju Platform dilacak di tingkat masing-masing aplikasi atau pengguna, bergantung pada jenis token yang digunakan dalam permintaan.

Aplikasi

Permintaan Graph API yang dilakukan dengan token akses aplikasi dihitung dari batas laju aplikasi tersebut. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukan selama satu jam bergulir dan dihitung sebagai berikut:

Jumlah Pengguna didasarkan pada jumlah pengguna aktif harian yang unik, yang dimiliki aplikasi. Jika terdapat periode penggunaan harian yang lambat, misalnya jika aplikasi memiliki aktivitas yang tinggi di akhir pekan tetapi sedikit aktivitas di hari biasa, Pengguna aktif mingguan dan bulanan digunakan untuk menghitung jumlah Pengguna aplikasi. Aplikasi dengan interaksi harian yang tinggi akan memiliki batas laju yang lebih tinggi daripada aplikasi dengan interaksi harian yang rendah, tanpa mempertimbangkan jumlah penginstalan aplikasi yang sebenarnya.

Perlu diperhatikan bahwa ini bukan batas per Pengguna, tetapi batas panggilan yang dilakukan oleh aplikasi. Tiap Pengguna dapat melakukan lebih dari 200 panggilan per jam menggunakan aplikasi, selama total panggilan dari aplikasi tidak melebihi maksimum aplikasi. Contoh: jika aplikasi memiliki 100 Pengguna, aplikasi dapat melakukan 20.000 panggilan per jam. Namun, sepuluh Pengguna teratas yang paling banyak berinteraksi dapat melakukan 19.000 panggilan itu.

Pengguna

Permintaan Graph API yang dilakukan dengan token akses pengguna dihitung dari jumlah panggilan pengguna tersebut. Jumlah panggilan pengguna adalah jumlah panggilan yang dapat dilakukan oleh pengguna selama satu jam bergulir. Karena masalah privasi, kami tidak mengungkapkan nilai jumlah panggilan sebenarnya bagi pengguna.

Perlu diperhatikan bahwa jumlah panggilan pengguna dapat tersebar pada beberapa aplikasi. Misalnya, pengguna dapat melakukan X panggilan melalui App1 dan Y panggilan melalui App2. Jika X+Y melebihi jumlah panggilan pengguna, pengguna tersebut akan dikenakan batas laju. Ini tidak berarti bahwa aplikasi melakukan kesalahan; bisa jadi pengguna menggunakan beberapa aplikasi atau salah menggunakan API.

Header

Endpoint yang menerima cukup permintaan dari aplikasi akan menyertakan header HTTP X-App-Usage atau X-Ad-Account-Usage (untuk panggilan API Iklan v3.3 dan lebih lama) dalam tanggapannya. Header berisi string format JSON yang menjelaskan penggunaan batas laju aplikasi saat ini.

Konten Header

Konten Header X-Ad-Account-Usage

Total Waktu CPU

Jumlah waktu CPU yang diperlukan oleh permintaan untuk memproses. Saat total_cputime mencapai 100, panggilan mungkin terhambat.

Total Waktu

Lamanya waktu yang diperlukan untuk memproses permintaan. Saat total_time mencapai 100, panggilan mungkin terhambat.

Contoh Nilai Header Penggunaan-X-App

x-app-usage: {
    "call_count": 28,         //Percentage of calls made 
    "total_time": 25,         //Percentage of total time
    "total_cputime": 25       //Percentage of total CPU time
}

Contoh Nilai Header Penggunaan-Akun-X-Iklan

x-ad-account-usage: {
    "acc_id_util_pct": 9.67,   //Percentage of calls made for this ad account.
    "reset_time_duration": 100,   //Time duration (in seconds) it takes to reset the current rate limit score.
    "ads_api_access_tier": 'standard_access'   //Tiers allows your app to access the Marketing API. standard_access enables lower rate limiting.
}

Dasbor

Dasbor aplikasi menampilkan jumlah pengguna yang dikenai batas laju, persentase penggunaan Batas Laju Aplikasi, dan menampilkan rata-rata aktivitas selama 7 hari terakhir. Di kartu Batas Laju Aplikasi, klik Lihat Detail dan arahkan kursor ke titik mana saja pada grafik untuk melihat detail selengkapnya tentang penggunaan untuk momen tertentu tersebut. Karena penggunaan bergantung pada volume panggilan, grafik ini mungkin tidak menampilkan data 7 hari penuh. Aplikasi dengan volume panggilan yang lebih tinggi akan menunjukkan lebih banyak hari.

Kode Kesalahan

Saat aplikasi atau pengguna telah mencapai batas lajunya, permintaan yang dilakukan oleh aplikasi atau pengguna tersebut akan gagal dan API akan menanggapi dengan kode kesalahan.

Kode Kesalahan Pelambatan

Contoh Tanggapan

{
  "error": {
    "message": "(#32) Page request limit reached",
    "type": "OAuthException",
    "code": 32,
    "fbtrace_id": "Fz54k3GZrio"
  }
}

Kode Pelambatan Stabilitas Facebook

Praktik Terbaik

• Saat batas telah tercapai, berhenti melakukan panggilan API. Terus melakukan panggilan akan terus meningkatkan jumlah panggilan, sehingga akan meningkatkan waktu sebelum panggilan akan berhasil lagi.
• Sebarkan kueri secara merata untuk menghindari lonjakan traffic.
• Gunakan filter untuk membatasi ukuran tanggapan data dan menghindari panggilan yang meminta data yang tumpang tindih.
• Periksa header HTTP X-App-Usage untuk melihat seberapa dekat aplikasi mendekati batasnya dan kapan Anda dapat melanjutkan panggilan saat batas telah tercapai.
• Jika Pengguna sedang terhambat, pastikan bukan aplikasi Anda penyebabnya. Kurangi panggilan pengguna atau sebarkan panggilan pengguna secara lebih merata sepanjang waktu.

Batas Laju Kasus Penggunaan Bisnis

Semua permintaan API Marketing, dan permintaan Pages API yang dilakukan dengan token sistem atau akses halaman, dikenai Batas Laju Kasus Penggunaan Bisnis (BUC), dan bergantung pada endpoint yang sedang Anda kueri.

Untuk API Marketing, batas laju diterapkan ke akun iklan di seluruh Kasus Penggunaan Bisnis yang sama. Contoh, semua endpoint dengan kasus penggunaan bisnis Pengelolaan Iklan akan berbagi total kuota dalam akun iklan yang sama. Jika endpoint tertentu membuat banyak permintaan API dan menyebabkan pelambatan, endpoint lain yang dikonfigurasi dengan kasus penggunaan bisnis yang sama juga akan menerima kesalahan pembatasan laju. Kuota tergantung pada Tingkat Akses API Marketing aplikasi. Tingkat Marketing API akses standar akan memiliki lebih banyak kuota dibandingkan tingkat Marketing API akses pengembangan. Secara default, aplikasi baru harus berada pada tingkat pengembangan. Jika Anda perlu meningkatkan untuk memperoleh kuota pembatasan laju yang lebih tinggi, tingkatkan ke Akses Lanjutan pada Akses Standar Pengelolaan Iklan di Tinjauan Aplikasi.

Insight Iklan

Permintaan yang dibuat oleh aplikasi Anda ke Ads Insight API dihitung berdasarkan metrik batas laju aplikasi seperti jumlah panggilan, total waktu CPU, dan total waktu. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukan selama termin satu jam bergulir dan dihitung sebagai berikut:

Untuk aplikasi dengan Akses Standar ke fitur Akses Standar Pengelolaan Iklan:

Untuk aplikasi dengan Akses Lanjutan ke fitur Akses Standar Pengelolaan Iklan:

Jumlah Iklan Aktif adalah jumlah iklan yang saat ini berjalan per akun iklan. Kesalahan Pengguna adalah jumlah kesalahan yang diterima saat memanggil API. Untuk mendapatkan batas laju yang lebih tinggi, Anda bisa meminta akses untuk fitur Akses Standar Pengelolaan Iklan.

Pembatasan laju juga dapat bergantung pada total waktu CPU dan total waktu aktual selama periode satu jam bergulir. Untuk detail selengkapnya, periksa X-Business-Use-Case header HTTP total_cputime dan total_time.

Jika menerima kesalahan pembatasan laju, Anda juga dapat merujuk ke estimated_time_to_regain_access di header X-Business-Use-Case untuk estimasi waktu pemblokiran.

Pengelolaan Iklan

Permintaan yang dibuat oleh aplikasi Anda ke Ads Management API dihitung berdasarkan metrik batas laju aplikasi seperti jumlah panggilan, total waktu CPU, dan total waktu. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukannya selama periode satu jam bergulir dan dihitung sebagai berikut:

Untuk aplikasi dengan Akses Standarke fitur Akses Standar Pengelolaan Iklan:

Untuk aplikasi dengan Akses Lanjutan ke fitur Akses Standar Pengelolaan Iklan:

Jumlah Iklan Aktif adalah jumlah iklan untuk tiap akun iklan.

Pembatasan laju juga dapat bergantung pada total waktu CPU dan total waktu aktual selama periode satu jam bergulir. Untuk detail selengkapnya, periksa X-Business-Use-Case header HTTP total_cputime dan total_time.

Jika menerima kesalahan pembatasan laju, Anda juga dapat merujuk ke estimated_time_to_regain_access di header X-Business-Use-Case untuk estimasi waktu pemblokiran.

Katalog

Batch Katalog

Permintaan yang dibuat oleh aplikasi Anda dihitung berdasarkan metrik batas laju seperti jumlah panggilan, total waktu CPU, dan total waktu yang dapat dilakukan aplikasi Anda dalam jangka waktu satu jam per setiap ID katalog dan dihitung sebagai berikut:

Pengguna unik adalah sejumlah pengguna unik bisnis (di semua katalog) dengan intensi dalam 28 hari terakhir. Makin banyak pengguna melihat produk dari katalog Anda, makin banyak kuota panggilan yang dialokasikan.

Pengelolaan Katalog

Permintaan yang dibuat oleh aplikasi Anda dihitung terhadap jumlah panggilan yang dapat dilakukan aplikasi Anda dalam periode bergulir satu jam per setiap ID katalog dan dihitung sebagai berikut:

Pengguna unik adalah sejumlah pengguna unik bisnis (di semua katalog) dengan niat dalam 28 hari terakhir. Makin banyak pengguna melihat produk dari katalog Anda, makin banyak kuota panggilan yang dialokasikan.

Formula ini diterapkan pada berbagai endpoint katalog.

Untuk informasi selengkapnya tentang cara mengetahui penggunaan laju Anda saat ini, lihat Header.

Pembatasan laju juga dapat bergantung pada total waktu CPU dan total waktu aktual selama periode satu jam bergulir. Untuk detail selengkapnya, periksa X-Business-Use-Case header HTTP total_cputime dan total_time.

Jika Anda menerima kesalahan pembatasan laju, Anda juga dapat merujuk ke estimated_time_to_regain_access di header X-Business-Use-Case untuk waktu estimasi pemblokiran.

Pemirsa Khusus

Permintaan yang dibuat oleh aplikasi Anda ke Custom Audience API dihitung berdasarkan metrik batas laju aplikasi seperti jumlah panggilan, total waktu CPU, dan total waktu. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukan selama jangka waktu satu jam bergulir dan dihitung sebagai berikut, tetapi tidak akan pernah melebihi 700.000:

Untuk aplikasi dengan Akses Standar ke fitur Akses Standar Pengelolaan Iklan:

Untuk aplikasi dengan Akses Lanjutan ke fitur Akses Standar Pengelolaan Iklan:

Jumlah Pemirsa Khusus Aktif adalah jumlah pemirsa khusus aktif untuk setiap akun iklan.

Pembatasan laju juga dapat bergantung pada total waktu CPU dan total waktu aktual selama termin satu jam bergulir. Untuk detail selengkapnya, periksa X-Business-Use-Case header HTTP total_cputime dan total_time.

Jika menerima kesalahan pembatasan laju, Anda juga dapat merujuk ke estimated_time_to_regain_access di header X-Business-Use-Case untuk estimasi waktu pemblokiran.

Platform Instagram

LeadGen

Permintaan yang dibuat oleh aplikasi Anda ke API Penciptaan Prospek dihitung terhadap jumlah panggilan aplikasi. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukannya selama periode 24 jam yang bergulir dan dihitung sebagai berikut:

Jumlah Prospek yang Diciptakan adalah jumlah prospek yang diciptakan per Halaman untuk Akun Iklan ini selama 90 hari terakhir.

Platform Messenger

Halaman

Batas Laju Halaman dapat menggunakan logika batas laju Platform atau BUC bergantung pada jenis token yang digunakan. Panggilan Pages API yang dilakukan menggunakan token Halaman atau token akses pengguna sistem menggunakan perhitungan batas laju di bawah. Panggilan yang dilakukan dengan token aplikasi atau token akses pengguna dikenai batas laju aplikasi atau Pengguna.

Permintaan yang dilakukan oleh aplikasi ke Pages API menggunakan token akses Halaman atau token akses Pengguna sistem dihitung sebagai bagian dari jumlah panggilan aplikasi. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukannya selama periode 24 jam bergulir dan dihitung sebagai berikut:

Jumlah Pengguna yang Berinteraksi adalah jumlah Pengguna yang berinteraksi dengan Halaman per 24 jam.

Permintaan yang dilakukan oleh aplikasi ke Pages API menggunakan token akses Pengguna atau token akses Aplikasi mengikuti logika Batas Laju Platform.

Untuk menghindari masalah pembatasan laju ketika menggunakan fitur Konten Akses Publik Halaman, penggunaan token akses pengguna sistem direkomendasikan.

Pengelolaan Efek Spark AR Commerce

Permintaan yang dibuat oleh aplikasi ke endpoint Commerce apa pun dihitung terhadap jumlah panggilan aplikasi. Jumlah panggilan aplikasi adalah jumlah panggilan yang dapat dilakukannya selama periode satu jam bergulir dan dihitung sebagai berikut:

Jumlah Katalog adalah jumlah total katalog di semua akun dagang yang dikelola oleh aplikasi Anda.

Threads

API Pengelolaan WhatsApp Business

Header

Semua tanggapan API yang dilakukan aplikasi yang dikenai batas laju menggunakan logika BUC menyertakan header HTTP X-Business-Use-Case-Usage (untuk panggilan API Iklan v3.3 dan lebih lama) dengan string format JSON yang menjelaskan penggunaan batas laju aplikasi saat ini. Header ini dapat mengembalikan hingga 32 objek dalam satu panggilan.

Konten Header Penggunaan Kasus-Penggunaan-X-Bisnis

Total Waktu CPU

Jumlah waktu CPU yang diperlukan untuk memproses permintaan. Saat total_cputime mencapai 100, panggilan mungkin terhambat.

Total Waktu

Lamanya waktu yang diperlukan oleh permintaan untuk memproses. Saat total_time mencapai 100, panggilan mungkin terhambat.

Tingkat Akses Ads API

Hanya untuk jenis ads_insights dan ads_management. Tingkat memungkinkan aplikasi Anda untuk mengakses Marketing API. Secara default, aplikasi ada di tingkat development_access dan Standard_access memungkinkan pembatasan laju yang lebih rendah. Untuk mendapatkan batas laju yang lebih tinggi dan mencapai tingkat standar, Anda dapat mengajukan "Akses Lanjutan" ke fitur Akses Standar Pengelolaan Iklan.

Contoh Nilai Header Penggunaan-Kasus-Penggunaan-X-Bisnis

x-business-use-case-usage: {
    "{business-object-id}": [
        {
            "type": "{rate-limit-type}",           //Type of BUC rate limit logic being applied.
            "call_count": 100,                     //Percentage of calls made. 
            "total_cputime": 25,                   //Percentage of the total CPU time that has been used.
            "total_time": 25,                      //Percentage of the total time that has been used.   
            "estimated_time_to_regain_access": 19,  //Time in minutes to regain access.
            "ads_api_access_tier": "standard_access"  //Tiers allows your app to access the Marketing API. standard_access enables lower rate limiting.
        }
    ],      
    "66782684": [
        {
            "type": "ads_management",
            "call_count": 95,
            "total_cputime": 20,
            "total_time": 20,
            "estimated_time_to_regain_access": 0,
            "ads_api_access_tier": "development_access" 
        }
    ],
    "10153848260347724": [
        {
            "type": "ads_insights",
            "call_count": 97,
            "total_cputime": 23,
            "total_time": 23,
            "estimated_time_to_regain_access": 0,
            "ads_api_access_tier": "development_access"
        }
    ],
    "10153848260347724": [
        {
            "type": "pages",
            "call_count": 97,
            "total_cputime": 23,
            "total_time": 23,
            "estimated_time_to_regain_access": 0
        }
    ],
...
}

Kode Kesalahan

Saat aplikasi mencapai batas laju Kasus Penggunaan Bisnis, permintaan selanjutnya yang dilakukan oleh aplikasi akan gagal dan API akan menanggapi dengan kode kesalahan.

Pesan Kode Contoh Kesalahan

{   
"error": {      
    "message": "(#80001) There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.",      
    "type": "OAuthException",      
    "code": 80001,      
    "fbtrace_id": "AmFGcW_3hwDB7qFbl_QdebZ"   
    }
}

Praktik Terbaik

• Saat batas telah tercapai, berhenti melakukan panggilan API. Terus melakukan panggilan akan terus meningkatkan jumlah panggilan, sehingga akan meningkatkan waktu sebelum panggilan akan berhasil lagi.
• Periksa header HTTP X-Business-Use-Case-Usage untuk melihat seberapa dekat akun iklan Anda mendekati batasnya dan kapan Anda dapat melanjutkan panggilan.
• Verifikasi kode kesalahan dan endpoint API untuk mengonfirmasi jenis pelambatan.
• Beralih ke akun iklan lain dan kembali ke akun ini nanti.
• Lebih baik membuat iklan baru daripada mengubah iklan yang sudah ada.
• Sebarkan kueri secara merata di antara dua interval waktu untuk menghindari pengiriman traffic dalam kondisi spike.
• Gunakan filter untuk membatasi ukuran tanggapan data dan menghindari panggilan yang meminta data yang tumpang-tindih.

Pertanyaan Umum

Apa yang dianggap sebagai panggilan API?

Semua panggilan dihitung dari batas laju, bukan hanya permintaan API satu per satu. Contoh: Anda dapat melakukan satu permintaan API yang menyebutkan beberapa ID, tetapi tiap ID dihitung sebagai satu panggilan API.

Tabel berikut menggambarkan konsep ini.

Kami sangat merekomendasikan agar menyebutkan beberapa ID dalam satu permintaan API jika memungkinkan, karena ini meningkatkan kinerja tanggapan API.

Saya membangun scraper, apa ada hal lain yang harus saya khawatirkan?

Jika Anda membangun layanan yang men-scrape data, harap baca ketentuan scraping kami.