API Đồ thị

Giới hạn tốc độ

Giới hạn tốc độ là số lệnh gọi API mà một ứng dụng hoặc một người dùng có thể thực hiện trong khoảng thời gian nhất định. Nếu vượt quá giới hạn này hoặc giới hạn CPU/tổng thời gian thì ứng dụng hoặc người dùng đó có thể bị giới hạn tốc độ. Các yêu cầu API do người dùng hoặc ứng dụng bị giới hạn tốc độ thực hiện sẽ không thành công.

Mọi yêu cầu API đều phải tuân theo giới hạn tốc độ. Các yêu cầu API Đồ thị và API Instagram Basic Display sẽ tuân theo Giới hạn tốc độ trên nền tảng, còn các yêu cầu API Marketing và trên Nền tảng Instagram sẽ tuân theo Giới hạn tốc độ cho trường hợp sử dụng của doanh nghiệp (BUC).

Các yêu cầu API Trang sẽ tuân theo Giới hạn tốc độ trên nền tảng hoặc Giới hạn tốc độ cho BUC, tùy thuộc vào mã được dùng trong yêu cầu; các yêu cầu được thực hiện bằng mã truy cập ứng dụng hoặc mã truy cập dành cho người dùng sẽ tuân theo Giới hạn tốc độ trên nền tảng, còn các yêu cầu được thực hiện bằng mã truy cập dành cho người dùng hệ thống hoặc mã truy cập trang sẽ tuân theo Giới hạn tốc độ cho trường hợp sử dụng của doanh nghiệp.

Số liệu thống kê về mức sử dụng giới hạn tốc độ trong thời gian thực được mô tả trong tiêu đề đi kèm với hầu hết phản hồi API sau khi thực hiện đủ lệnh gọi đến một điểm cuối. Số liệu thống kê về mức sử dụng Giới hạn tốc độ trên nền tảng cũng hiển thị trong Bảng điều khiển ứng dụng. Sau khi đạt đến giới hạn tốc độ, mọi yêu cầu tiếp theo do ứng dụng của bạn thực hiện đều không thành công và API sẽ trả về mã lỗi cho đến khi đủ thời gian để số lượng lệnh gọi giảm xuống dưới mức giới hạn.

Nếu có thể áp dụng cả giới hạn tốc độ trên Nền tảng lẫn giới hạn tốc độ cho BUC cho một yêu cầu, giới hạn tốc độ cho BUC sẽ được áp dụng.

Giới hạn tốc độ trên nền tảng

Giới hạn tốc độ trên nền tảng được theo dõi trên từng cấp ứng dụng hoặc cấp người dùng, tùy thuộc vào loại mã được dùng trong yêu cầu.

Ứng dụng

Các yêu cầu API Đồ thị được thực hiện bằng mã truy cập ứng dụng sẽ được tính vào giới hạn tốc độ của ứng dụng đó. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục và được tính như sau:

Calls within one hour = 200 * Number of Users

Số người dùng được tính dựa trên số người dùng hoạt động hàng ngày khác nhau của một ứng dụng. Trong trường hợp có những khoảng thời gian sử dụng hàng ngày diễn ra chậm, chẳng hạn như nếu ứng dụng có mức hoạt động cao vào ngày cuối tuần nhưng lại thấp vào ngày trong tuần, số Người dùng hoạt động hàng tuần và hàng tháng sẽ được dùng để tính số Người dùng cho ứng dụng của bạn. Ứng dụng có mức tương tác hàng ngày cao sẽ có giới hạn tốc độ cao hơn ứng dụng có mức tương tác hàng ngày thấp, bất kể số lượt cài đặt ứng dụng thực tế là bao nhiêu.

Lưu ý rằng đây không phải là giới hạn trên mỗi Người dùng mà là giới hạn về số lệnh gọi của ứng dụng. Người dùng nào cũng có thể thực hiện hơn 200 lệnh gọi mỗi giờ thông qua ứng dụng của bạn, với điều kiện là tổng số lệnh gọi từ ứng dụng đó không vượt quá mức tối đa của ứng dụng. Ví dụ: nếu có 100 Người dùng thì ứng dụng của bạn có thể thực hiện 20.000 lệnh gọi mỗi giờ. Tuy nhiên, 10 Người dùng tương tác nhiều nhất có thể thực hiện 19.000 lệnh gọi trong số đó.

Người dùng

Các yêu cầu API Đồ thị được thực hiện bằng mã truy cập dành cho người dùng sẽ được tính vào số lượng lệnh gọi của người dùng đó. Số lệnh gọi của một người dùng là số lệnh gọi mà người dùng đó có thể thực hiện trong khoảng thời gian 1 giờ. Do lo ngại về quyền riêng tư, chúng tôi sẽ không tiết lộ giá trị số lệnh gọi thực tế của người dùng.

Lưu ý rằng số lệnh gọi của người dùng có thể dàn trải trên nhiều ứng dụng. Ví dụ: một người dùng có thể thực hiện X lệnh gọi thông qua Ứng dụng 1 và Y lệnh gọi thông qua Ứng dụng 2. Nếu X+Y vượt quá số lệnh gọi của người dùng, người dùng đó sẽ bị giới hạn tốc độ. Điều này không hẳn là do ứng dụng nào đó có vấn đề; có khả năng là do người dùng đang sử dụng nhiều ứng dụng hoặc đang sử dụng API sai mục đích.

Tiêu đề

Các điểm cuối nhận được đủ yêu cầu từ ứng dụng của bạn sẽ thêm tiêu đề HTTP X-App-Usage hoặc X-Ad-Account-Usage (đối với lệnh gọi API Quảng cáo v3.3 trở xuống) vào phản hồi. Tiêu đề này sẽ có một chuỗi ở định dạng JSON mô tả mức sử dụng giới hạn tốc độ ứng dụng hiện tại.

Nội dung tiêu đề


KhóaMô tả giá trị

call_count

Số nguyên biểu thị phần trăm lệnh gọi do ứng dụng của bạn thực hiện trong khoảng thời gian 1 giờ.

total_cputime

Số nguyên biểu thị phần trăm thời gian CPU được phân bổ để xử lý truy vấn.

total_time

Số nguyên biểu thị phần trăm tổng thời gian được phân bổ để xử lý truy vấn.

Nội dung tiêu đề X-Ad-Account-Usage

KhóaMô tả giá trị

acc_id_util_pct

Tỷ lệ phần trăm lệnh gọi đã thực hiện của tài khoản quảng cáo này trước khi đạt đến giới hạn tốc độ.

reset_time_duration

Khoảng thời gian (tính bằng giây) cần thiết để đặt lại giới hạn tốc độ hiện tại về 0.

ads_api_access_tier

Cấp truy cập cho phép ứng dụng của bạn truy cập API Marketing. Theo mặc định, ứng dụng của bạn ở cấp development_access. Standard_access hỗ trợ giới hạn tốc độ thấp hơn. Nếu muốn tăng giới hạn tốc độ và có cấp tiêu chuẩn, bạn có thể đăng ký "Quyền truy cập tiêu chuẩn" cho tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

Tổng thời gian CPU

Lượng thời gian CPU cần để xử lý yêu cầu. Khi total_cputime đạt đến 100, các lệnh gọi có thể bị giới hạn tốc độ.

Tổng thời gian

Khoảng thời gian cần để xử lý yêu cầu. Khi total_time đạt đến 100, các lệnh gọi có thể bị giới hạn tốc độ.

Giá trị tiêu đề X-App-Usage mẫu

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
}

Giá trị tiêu đề X-Ad-Account-Usage mẫu

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.
}

Bảng điều khiển

Bảng điều khiển ứng dụng hiển thị số người dùng ứng dụng bị giới hạn tốc độ, phần trăm sử dụng Giới hạn tốc độ ứng dụng hiện tại của ứng dụng, cũng như hiển thị mức hoạt động trung bình trong 7 ngày qua. Trong thẻ Giới hạn tốc độ ứng dụng, hãy nhấp vào Xem chi tiết và di chuột qua điểm bất kỳ trên đồ thị để xem thêm thông tin chi tiết về mức sử dụng tại thời điểm cụ thể đó. Vì mức sử dụng phụ thuộc vào số lệnh gọi nên đồ thị này có thể không hiển thị đủ 7 ngày. Ứng dụng có số lệnh gọi cao hơn sẽ hiển thị nhiều ngày hơn.

Mã lỗi

Khi một ứng dụng hoặc người dùng đã đạt đến giới hạn tốc độ của mình, các yêu cầu do ứng dụng hoặc người dùng đó thực hiện sẽ không thành công và API sẽ phản hồi kèm theo mã lỗi.

Mã lỗi giới hạn tốc độ


Mã lỗiMô tả

4

Cho biết rằng ứng dụng có mã đang được dùng trong yêu cầu đã đạt đến giới hạn tốc độ của ứng dụng đó.

17

Cho biết rằng Người dùng có mã đang được dùng trong yêu cầu đã đạt đến giới hạn tốc độ của Người dùng đó.

17 with subcode 2446079

Cho biết rằng mã đang được dùng trong yêu cầu API Quảng cáo v3.3 trở xuống đã đạt đến giới hạn tốc độ của mã đó.

32

Cho biết rằng Người dùng hoặc ứng dụng có mã đang được dùng trong yêu cầu API Trang đã đạt đến giới hạn tốc độ của Người dùng hoặc ứng dụng đó.

613

Cho biết đã đạt đến giới hạn tốc độ tùy chỉnh. Để giải quyết vấn đề này, hãy tham khảo tài liệu hỗ trợ về API cụ thể mà bạn đang gọi để biết các giới hạn tốc độ tùy chỉnh có thể được áp dụng.

613 with subcode 1996

Cho biết rằng chúng tôi đã nhận thấy hành vi không nhất quán trong số yêu cầu API từ ứng dụng của bạn. Bạn có thể gặp phải lỗi này nếu đã thực hiện bất kỳ thay đổi nào gần đây ảnh hưởng đến số yêu cầu API.

Phản hồi mẫu

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

Mã giới hạn tốc độ cho sự ổn định trên Facebook


Mã lỗiMô tả

throttled

Liệu truy vấn có bị giới hạn tốc độ hay không. Giá trị: True, False

backend_qps

Yếu tố giới hạn tốc độ thứ nhất backend_qps. Giá trị được hỗ trợ:

  • actual_score - backend_qps thực tế của ứng dụng này. Giá trị: 8
  • limit - Giới hạn backend_qps của ứng dụng này. Giá trị: 5
  • more_info - Các truy vấn cần có lượng lớn yêu cầu phụ trợ để xử lý. Bạn nên gửi ít truy vấn hơn hoặc đơn giản hóa các truy vấn bằng khoảng thời gian ngắn hơn, ít ID đối tượng hơn, v.v.

complexity_score

Yếu tố giới hạn tốc độ thứ hai complexity_score. Giá trị được hỗ trợ:

  • actual_score - complexity_score thực tế của ứng dụng này. Giá trị: 0.1
  • limit - Giới hạn complexity_score của ứng dụng này. Giá trị: 0.01
  • more_info – complexity_score cao nghĩa là các truy vấn của bạn rất phức tạp và yêu cầu lượng lớn dữ liệu. Bạn nên đơn giản hóa các truy vấn bằng khoảng thời gian ngắn hơn, ít ID đối tượng, số liệu hoặc số liệu chia nhỏ hơn, v.v. Hãy tách các truy vấn lớn, phức tạp thành nhiều truy vấn nhỏ hơn và giãn cách ra.

Cách làm tốt nhất

  • Khi đã đạt đến giới hạn, hãy ngừng thực hiện lệnh gọi API. Nếu tiếp tục thực hiện thì số lệnh gọi của bạn sẽ tăng lên, làm tăng thời gian trước khi lệnh gọi thành công trở lại.
  • Dàn trải đều truy vấn để tránh làm lưu lượng truy cập tăng vọt.
  • Sử dụng bộ lọc để giới hạn kích thước phản hồi dữ liệu và tránh các lệnh gọi yêu cầu dữ liệu chồng chéo.
  • Kiểm tra tiêu đề HTTP X-App-Usage để xem ứng dụng của bạn gần giới hạn đến mức nào và khi nào bạn có thể tiếp tục thực hiện lệnh gọi nếu đã đạt đến giới hạn.
  • Nếu Người dùng đang bị giới hạn tốc độ, hãy đảm bảo nguyên nhân không phải là do ứng dụng của bạn. Giảm bớt số lệnh gọi của người dùng hoặc dàn trải số lệnh gọi của người dùng đều hơn theo thời gian.

Giới hạn tốc độ cho trường hợp sử dụng của doanh nghiệp

Mọi yêu cầu API Marketing và yêu cầu API Trang được thực hiện bằng mã truy cập hệ thống hoặc mã truy cập trang đều tuân theo Giới hạn tốc độ cho trường hợp sử dụng của doanh nghiệp (BUC), đồng thời phụ thuộc vào các điểm cuối mà bạn đang truy vấn.

Đối với API Marketing, giới hạn tốc độ được áp dụng cho tài khoản quảng cáo trong cùng một Trường hợp sử dụng của doanh nghiệp. Ví dụ: tất cả điểm cuối có trường hợp sử dụng của doanh nghiệp là Quản lý quảng cáo sẽ dùng chung một định mức tổng trong cùng một tài khoản quảng cáo. Nếu một điểm cuối nhất định thực hiện nhiều yêu cầu API và gây ra lỗi giới hạn tốc độ, các điểm cuối khác được đặt cấu hình với cùng trường hợp sử dụng của doanh nghiệp cũng sẽ gặp lỗi giới hạn tốc độ. Định mức này phụ thuộc vào Cấp truy cập API Marketing của ứng dụng. Cấp API Marketing quyền truy cập tiêu chuẩn sẽ có định mức lớn hơn cấp API Marketing quyền truy cập phát triển. Theo mặc định, ứng dụng mới sẽ ở cấp phát triển. Nếu bạn cần nâng cấp để tăng định mức giới hạn tốc độ, hãy nâng cấp lên Quyền truy cập nâng cao vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo trong quy trình Xét duyệt ứng dụng.

Thông tin chi tiết về quảng cáo

Các yêu cầu do ứng dụng của bạn gửi đến API Thông tin chi tiết về quảng cáo sẽ được tính vào số liệu giới hạn tốc độ của ứng dụng, chẳng hạn như số lệnh gọi, tổng thời gian CPU và tổng thời gian. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục và được tính như sau:

Đối với ứng dụng có Quyền truy cập tiêu chuẩn vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 600 + 400 * Number of Active ads - 0.001 * User Errors

Đối với ứng dụng có Quyền truy cập nâng cao vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 190000 + 400 * Number of Active ads - 0.001 * User Errors

Số quảng cáo đang hoạt động là số quảng cáo hiện đang chạy trên mỗi tài khoản quảng cáo. Lỗi người dùng là số lỗi nhận được khi gọi API. Để có giới hạn tốc độ cao hơn, bạn có thể đăng ký tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

Giới hạn tốc độ cũng có thể phụ thuộc vào tổng thời gian CPU và tổng thời gian trên tường trong khoảng thời gian 1 giờ liên tục. Để biết thêm chi tiết, hãy kiểm tra total_cputime và total_time trong tiêu đề HTTP X-Business-Use-Case.

Nếu gặp lỗi giới hạn tốc độ, bạn cũng có thể tham khảo estimated_time_to_regain_access trong tiêu đề X-Business-Use-Case để biết thời gian chặn ước tính.

Quản lý quảng cáo

Các yêu cầu do ứng dụng của bạn gửi đến API Quản lý quảng cáo sẽ được tính vào số liệu giới hạn tốc độ của ứng dụng, chẳng hạn như số lệnh gọi, tổng thời gian CPU và tổng thời gian. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục và được tính như sau:

Đối với ứng dụng có Quyền truy cập tiêu chuẩn vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 300 + 40 * Number of Active ads

Đối với ứng dụng có Quyền truy cập nâng cao vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 100000 + 40 * Number of Active ads

Số quảng cáo đang hoạt động là số quảng cáo của từng tài khoản quảng cáo.

Giới hạn tốc độ cũng có thể phụ thuộc vào tổng thời gian CPU và tổng thời gian trên tường trong khoảng thời gian 1 giờ liên tục. Để biết thêm chi tiết, hãy kiểm tra total_cputime và total_time trong tiêu đề HTTP X-Business-Use-Case.

Nếu gặp lỗi giới hạn tốc độ, bạn cũng có thể tham khảo estimated_time_to_regain_access trong tiêu đề X-Business-Use-Case để biết thời gian chặn ước tính.

Danh mục

Loạt danh mục

Những yêu cầu do ứng dụng của bạn gửi sẽ được tính vào số liệu giới hạn tốc độ, chẳng hạn như số lệnh gọi, tổng thời gian CPU và tổng thời gian mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục trên mỗi ID danh mục và được tính như sau:

Calls within one hour = 200 + 200 * log2(unique users)

Số người dùng là số lượng người dùng của doanh nghiệp (trên tất cả danh mục) có ý định trong 28 ngày qua. Số người dùng xem sản phẩm trong danh mục của bạn càng nhiều thì định mức lệnh gọi được phân bổ càng cao.

Loại lệnh gọi Điểm cuối

POST

/{catalog_id}/items_batch

POST

/{catalog_id}/localized_items_batch

POST

/{catalog_id}/batch

Quản lý danh mục

Những yêu cầu do ứng dụng của bạn gửi sẽ được tính vào số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian một giờ liên tục trên mỗi ID danh mục và được tính như sau:

Calls within one hour = 20,000 + 20,000 * log2(unique users)

Số người dùng là số lượng người dùng của doanh nghiệp (trên tất cả danh mục) có ý định trong 28 ngày qua. Số người dùng xem sản phẩm trong danh mục của bạn càng nhiều thì định mức lệnh gọi được phân bổ càng cao.

Công thức này được áp dụng trên nhiều điểm cuối danh mục khác nhau.

Để biết thêm thông tin về cách lấy mức sử dụng tốc độ hiện tại của bạn, hãy xem phần Tiêu đề.

Giới hạn tốc độ cũng có thể phụ thuộc vào tổng thời gian CPU và tổng thời gian trên tường trong khoảng thời gian 1 giờ liên tục. Để biết thêm chi tiết, hãy kiểm tra total_cputime và total_time trong tiêu đề HTTP X-Business-Use-Case.

Nếu gặp lỗi giới hạn tốc độ, bạn cũng có thể tham khảo estimated_time_to_regain_access trong tiêu đề X-Business-Use-Case để biết thời gian chặn ước tính.

Đối tượng tùy chỉnh

Các yêu cầu do ứng dụng của bạn gửi đến API Đối tượng tùy chỉnh sẽ được tính vào số liệu giới hạn tốc độ của ứng dụng, chẳng hạn như số lệnh gọi, tổng thời gian CPU và tổng thời gian. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục và được tính như sau (nhưng sẽ không bao giờ vượt quá 700.000):

Đối với ứng dụng có Quyền truy cập tiêu chuẩn vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 5000 + 40 * Number of Active Custom Audiences

Đối với ứng dụng có Quyền truy cập nâng cao vào tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo:

Calls within one hour = 190000 + 40 * Number of Active Custom Audiences

Số đối tượng tùy chỉnh đang hoạt động là số đối tượng tùy chỉnh đang hoạt động của từng tài khoản quảng cáo.

Giới hạn tốc độ cũng có thể phụ thuộc vào tổng thời gian CPU và tổng thời gian trên tường trong khoảng thời gian 1 giờ liên tục. Để biết thêm chi tiết, hãy kiểm tra total_cputime và total_time trong tiêu đề HTTP X-Business-Use-Case.

Nếu gặp lỗi giới hạn tốc độ, bạn cũng có thể tham khảo estimated_time_to_regain_access trong tiêu đề X-Business-Use-Case để biết thời gian chặn ước tính.

Nền tảng Instagram

Calls to the Instagram Platform endpoints, excluding messaging, are counted against the calling app's call count. An app's call count is unique for each app and app user pair, and is the number of calls the app has made in a rolling 24 hour window. It is calculated as follows:

Calls within 24 hours = 4800 * Number of Impressions

The Number of Impressions is the number of times any content from the app user's Instagram professional account has entered a person's screen within the last 24 hours.

Notes

  • The Instagram Basic Display API uses Platform Rate Limits.
  • Business Discovery and Hashtag Search API are subject to Platform Rate Limits.

    • Messaging Rate Limits

    Calls to the Instagram messaging endpoints are counted against the number of calls your app can make per Instagram professional account and the API used.

    Conversations API

    • Your app can make 2 calls per second per Instagram professional account.

    Private Replies API

    • Your app can make 100 calls per second per Instagram professional account for private replies to Instagram Live comments
    • Your app can make 750 calls per hour per Instagram professional account for private replies to comments on Instagram posts and reels

    Send API

    • Your app can make 100 calls per second per Instagram professional account for messages that contain text, links, reactions, and stickers
    • Your app can make 10 calls per second per Instagram professional account for messages that contain audio or video content

    Tìm kiếm khách hàng tiềm năng

    Các yêu cầu do ứng dụng của bạn gửi đến API Tìm kiếm khách hàng tiềm năng sẽ được tính vào số lệnh gọi của ứng dụng đó. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 24 giờ và được tính như sau:

    Calls within 24 hours = 4800 * Leads Generated

    Số khách hàng tiềm năng tìm được là số khách hàng tiềm năng tìm được trên mỗi Trang của Tài khoản quảng cáo này trong 90 ngày qua.

    Nền tảng Messenger

    Giới hạn tốc độ của Nền tảng Messenger phụ thuộc vào API được sử dụng và trong một số trường hợp còn phụ thuộc vào nội dung tin nhắn.

    API Messenger

    Những yêu cầu do ứng dụng của bạn gửi sẽ được tính vào số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 24 giờ và được tính như sau:

    Calls within 24 hours = 200 * Number of Engaged Users

    Number of Engaged Users (Số người dùng tương tác) là số người mà doanh nghiệp có thể nhắn tin qua Messenger.

    API Messenger dành cho Instagram

    Những yêu cầu do ứng dụng của bạn gửi sẽ được tính vào số lệnh gọi mà ứng dụng đó có thể thực hiện trong mỗi tài khoản Công việc trên Instagram và API được sử dụng.

    API Cuộc trò chuyện

    • Ứng dụng của bạn có thể thực hiện 2 lệnh gọi/giây trong mỗi tài khoản Công việc trên Instagram

    API Gửi

    • Ứng dụng của bạn có thể thực hiện 100 lệnh gọi/giây trong mỗi tài khoản Công việc trên Instagram đối với tin nhắn có chứa văn bản, liên kết, cảm xúc và nhãn dán
    • Ứng dụng của bạn có thể thực hiện 10 lệnh gọi/giây trong mỗi tài khoản Công việc trên Instagram đối với tin nhắn có chứa nội dung âm thanh hoặc video

    API Tin trả lời riêng tư

    • Ứng dụng của bạn có thể thực hiện 100 lệnh gọi/giây trong mỗi tài khoản Công việc trên Instagram đối với tin trả lời riêng tư cho bình luận trên Instagram Live
    • Ứng dụng của bạn có thể thực hiện 750 lệnh gọi/giây trong mỗi tài khoản Công việc trên Instagram đối với tin trả lời riêng tư cho bình luận về bài viết và thước phim trên Instagram

    Trang

    Giới hạn tốc độ của Trang có thể sử dụng logic giới hạn tốc độ trên Nền tảng hoặc cho BUC, tùy thuộc vào loại mã được dùng. Mọi lệnh gọi API Trang được thực hiện bằng mã truy cập Trang hoặc mã truy cập dành cho người dùng hệ thống đều áp dụng cách tính giới hạn tốc độ ở bên dưới. Mọi lệnh gọi được thực hiện bằng mã truy cập ứng dụng hoặc mã truy cập dành cho người dùng đều tuân theo giới hạn tốc độ của ứng dụng hoặc Người dùng.

    Các yêu cầu do ứng dụng của bạn gửi đến API Trang bằng mã truy cập Trang hoặc mã truy cập dành cho Người dùng hệ thống sẽ được tính vào số lệnh gọi của ứng dụng đó. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 24 giờ và được tính như sau:

    Calls within 24 hours = 4800 * Number of Engaged Users

    Số người dùng tương tác là số Người dùng đã tương tác với Trang trong 24 giờ.

    Các yêu cầu do ứng dụng của bạn gửi đến API Trang bằng mã truy cập dành cho Người dùng hoặc mã truy cập Ứng dụng sẽ tuân theo logic Giới hạn tốc độ trên nền tảng.

    Để tránh gặp vấn đề về giới hạn tốc độ khi sử dụng tính năng Truy cập vào nội dung công khai trên Trang, bạn nên dùng mã truy cập dành cho người dùng hệ thống.

    Quản lý hiệu ứng thương mại Spark AR

    Các yêu cầu do ứng dụng của bạn gửi đến bất kỳ điểm cuối Thương mại nào sẽ được tính vào số lệnh gọi của ứng dụng đó. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong khoảng thời gian 1 giờ liên tục và được tính như sau:

    Calls within one hour = 200 + 40 * Number of Catalogs

    Số lượng danh mục là tổng số danh mục trên tất cả tài khoản thương mại do ứng dụng của bạn quản lý.

    Threads

    Calls to the Threads API are counted against the calling app's call count. An app's call count is unique for each app and app user pair and is the number of calls the app has made in a rolling 24-hour window. It is calculated as follows:
    Calls within 24 hours = 4800 * Number of Impressions
    The Number of Impressions is the number of times any content from the app user's Threads account has entered a person's screen within the last 24 hours. Rate limiting may also be subject to total CPU time per day:
    720000 * number_of_impressions for total_cputime
    2880000 * Number of Impressions for total_time
    Note: The minimum value for impressions is 10 (so if the impressions is less than 10 we default to 10).

    WhatsApp Business Management API

    Những yêu cầu mà ứng dụng của bạn gửi đến API Quản lý WhatsApp Business sẽ được tính vào số lệnh gọi của ứng dụng đó. Số lệnh gọi của một ứng dụng là số lệnh gọi mà ứng dụng đó có thể thực hiện trong 1 giờ liên tục. Đối với API Quản lý WhatsApp Business dưới đây, theo mặc định, ứng dụng của bạn có thể thực hiện 200 lệnh gọi mỗi giờ trên mỗi ứng dụng cho mỗi Tài khoản WhatsApp Business (WABA). Đối với những WABA đang hoạt động có ít nhất một số điện thoại đã đăng ký, ứng dụng của bạn có thể thực hiện 5.000 lệnh gọi mỗi giờ trên mỗi ứng dụng cho mỗi WABA đang hoạt động.
    Loại lệnh gọi Điểm cuối

    GET

    /{whatsapp-business-account-id}

    GET, POST và DELETE

    /{whatsapp-business-account-id}/assigned_users

    GET

    /{whatsapp-business-account-id}/phone_numbers

    GET, POST và DELETE

    /{whatsapp-business-account-id}/message_templates

    GET, POST và DELETE

    /{whatsapp-business-account-id}/subscribed_apps

    GET

    /{whatsapp-business-account-to-number-current-status-id}

    Đối với API Hạn mức tín dụng dưới đây, ứng dụng của bạn có thể thực hiện 5.000 lệnh gọi mỗi giờ trên mỗi ứng dụng.
    Loại lệnh gọi Điểm cuối

    GET

    /{business-id}/extendedcredits

    POST

    /{extended-credit-id}/whatsapp_credit_sharing_and_attach

    GET và DELETE

    /{allocation-config-id}

    GET

    /{extended-credit-id}/owning_credit_allocation_configs

    Nhằm tránh đạt đến giới hạn tốc độ, bạn nên sử dụng webhook để theo dõi thông tin cập nhật trạng thái cho các mẫu tin nhắn, số điện thoại và WABA.

    Hãy xem phần Tiêu đề để biết thêm thông tin về cách nhận mức sử dụng tốc độ hiện tại của bạn.

    Tiêu đề

    Mọi phản hồi API do ứng dụng bị giới hạn tốc độ theo logic BUC thực hiện sẽ thêm tiêu đề HTTP X-Business-Use-Case-Usage (đối với lệnh gọi API Quảng cáo v3.3 trở xuống) kèm theo một chuỗi ở định dạng JSON mô tả mức sử dụng giới hạn tốc độ ứng dụng hiện tại. Tiêu đề này có thể trả về tối đa 32 đối tượng trong một lệnh gọi.

    Nội dung tiêu đề X-Business-Use-Case-Usage

    Mã lỗiMô tả giá trị

    business-id

    ID của doanh nghiệp được liên kết với mã thực hiện lệnh gọi API.

    call_count

    Số nguyên biểu thị phần trăm lệnh gọi mà ứng dụng của bạn được phép thực hiện trong khoảng thời gian 1 giờ.

    estimated_time_to_regain_access

    Thời gian (tính bằng phút) cho đến khi các lệnh gọi không bị giới hạn tốc độ nữa.

    total_cputime

    Số nguyên biểu thị phần trăm thời gian CPU được phân bổ để xử lý truy vấn.

    total_time

    Số nguyên biểu thị phần trăm tổng thời gian được phân bổ để xử lý truy vấn.

    type

    Loại giới hạn tốc độ được áp dụng. Giá trị có thể là một trong những loại sau: ads_insights, ads_management, custom_audience, instagram, leadgen, messenger hoặc pages.

    ads_api_access_tier

    Chỉ áp dụng với loại ads_insights và ads_management. Cấp truy cập cho phép ứng dụng của bạn truy cập API Marketing. Theo mặc định, ứng dụng của bạn ở cấp development_access. Standard_access hỗ trợ giới hạn tốc độ thấp hơn. Nếu muốn tăng giới hạn tốc độ và có cấp tiêu chuẩn, bạn có thể đăng ký "Quyền truy cập tiêu chuẩn" cho tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

    Tổng thời gian CPU

    Lượng thời gian CPU cần để xử lý yêu cầu. Khi total_cputime đạt đến 100, các lệnh gọi có thể bị giới hạn tốc độ.

    Tổng thời gian

    Khoảng thời gian cần để xử lý yêu cầu. Khi total_time đạt đến100, các lệnh gọi có thể bị giới hạn tốc độ.

    Cấp truy cập API Quảng cáo

    Chỉ áp dụng với loại ads_insights và ads_management. Cấp truy cập cho phép ứng dụng của bạn truy cập API Marketing. Theo mặc định, ứng dụng của bạn ở cấp development_access. Standard_access hỗ trợ giới hạn tốc độ thấp hơn. Nếu muốn tăng giới hạn tốc độ và có cấp tiêu chuẩn, bạn có thể đăng ký "Quyền truy cập tiêu chuẩn" cho tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

    Giá trị tiêu đề X-Business-Use-Case-Usage mẫu

    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
        }
    ],
...
}

    Mã lỗi

    Khi ứng dụng của bạn đạt đến giới hạn tốc độ cho Trường hợp sử dụng của doanh nghiệp, các yêu cầu tiếp theo do ứng dụng đó thực hiện sẽ không thành công và API sẽ phản hồi kèm theo mã lỗi.

    Mã lỗiLoại giới hạn tốc độ cho BUC

    error code 80000, error subcode 2446079

    Thông tin chi tiết về quảng cáo

    error code 80004, error subcode 2446079

    Quản lý quảng cáo

    error code 80003, error subcode 2446079

    Đối tượng tùy chỉnh

    error code 80002

    Instagram

    error code 80005

    Tìm kiếm khách hàng tiềm năng

    error code 80006

    Messenger

    error code 32

    Lệnh gọi Trang được thực hiện bằng mã truy cập dành cho Người dùng

    error code 80001

    Lệnh gọi Trang được thực hiện bằng mã truy cập Trang hoặc mã truy cập dành cho Người dùng hệ thống

    error code 17, error subcode 2446079

    API Quảng cáo v3.3 trở xuống ngoại trừ Thông tin chi tiết về quảng cáo

    error code 80008

    WhatsApp Business Management API

    error code 80014

    Loạt danh mục

    error code 80009

    Quản lý danh mục

    Thông báo mã lỗi mẫu

    {   
"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"   
    }
}

    Cách làm tốt nhất

    • Khi đã đạt đến giới hạn, hãy ngừng thực hiện lệnh gọi API. Nếu tiếp tục thực hiện thì số lệnh gọi của bạn sẽ tăng lên, làm tăng thời gian trước khi lệnh gọi thành công trở lại.
    • Kiểm tra tiêu đề HTTP X-Business-Use-Case-Usage để xem tài khoản quảng cáo của bạn gần giới hạn đến mức nào và khi nào bạn có thể tiếp tục thực hiện lệnh gọi.
    • Xác minh mã lỗi và điểm cuối API để xác nhận loại giới hạn tốc độ.
    • Chuyển sang tài khoản quảng cáo khác rồi quay lại tài khoản này sau.
    • Bạn nên tạo quảng cáo mới chứ không nên thay đổi quảng cáo hiện có.
    • Dàn trải đều truy vấn giữa hai khoảng thời gian để tránh làm lưu lượng truy cập tăng vọt.
    • Sử dụng bộ lọc để giới hạn kích thước phản hồi dữ liệu và tránh các lệnh gọi yêu cầu dữ liệu chồng chéo.

    Câu hỏi thường gặp

    Chúng ta sẽ xem lệnh gọi API là gì?

    Tất cả lệnh gọi đều được tính vào giới hạn tốc độ chứ không chỉ yêu cầu API. Ví dụ: bạn có thể tạo một yêu cầu API chỉ định nhiều ID, nhưng mỗi ID sẽ tính là một lệnh gọi API.

    Bảng dưới đây sẽ minh họa khái niệm này.

    Yêu cầu mẫu Số lệnh gọi API

    GET https://graph.facebook.com/photos?ids=4

    GET https://graph.facebook.com/photos?ids=5

    GET https://graph.facebook.com/photos?ids=6

    3

    GET https://graph.facebook.com/photos?ids=4,5,6

    3

    Bạn nên chỉ định nhiều ID trong một yêu cầu API nếu có thể để cải thiện hiệu quả phản hồi API.

    Tôi đang tạo một công cụ quét thông tin thì có cần chú ý đến điều gì khác không?

    Nếu bạn đang tạo một dịch vụ quét dữ liệu, hãy đọc điều khoản quét thông tin của chúng tôi.