API Đồ thị

Xử lý lỗi

Khi gửi yêu cầu đến API của chúng tôi, bạn có thể nhận được các phản hồi lỗi khác nhau. Tài liệu sau mô tả các chiến thuật phục hồi và cung cấp danh sách giá trị lỗi cùng sơ đồ chiến thuật phục hồi phổ biến nhất mà bạn có thể sử dụng.

Phản hồi lỗi

Dưới đây là một phản hồi lỗi phổ biến do yêu cầu API không thành công:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}
  • message: Nội dung mô tả lỗi mà người dùng có thể đọc được.
  • code: Mã lỗi. Giá trị phổ biến được liệt kê bên dưới, cùng với các chiến thuật phục hồi phổ biến.
  • error_subcode: Thông tin bổ sung về lỗi. Các giá trị phổ biến được liệt kê bên dưới.
  • error_user_msg: Thông báo hiển thị cho người dùng. Ngôn ngữ của thông báo này dựa vào ngôn ngữ của yêu cầu API.
  • error_user_title: Tiêu đề của hộp thoại, nếu được hiển thị. Ngôn ngữ của thông báo này dựa vào ngôn ngữ của yêu cầu API.
  • fbtrace_id: Thông tin nhận dạng hỗ trợ nội bộ. Khi báo cáo một lỗi có liên quan đến lệnh gọi API Đồ thị, hãy thêm fbtrace_id để chúng tôi có thể tìm dữ liệu nhật ký nhằm gỡ lỗi. Tuy nhiên, ID này sẽ sớm hết hạn. Để giúp đội ngũ hỗ trợ tái tạo vấn đề của bạn, hãy đính kèm phiên đăng nhập trình khám phá đồ thị đã lưu.

Mã lỗi

Mã hoặc loại Tên Việc cần làm

OAuthException

Nếu không có mã phụ nào, tức là trạng thái đăng nhập hoặc mã truy cập đã hết hạn, bị thu hồi hoặc không hợp lệ. Lấy mã truy cập mới.

Nếu có mã phụ, hãy xem mã phụ đó.

102

Phiên API

Nếu không có mã phụ nào, tức là trạng thái đăng nhập hoặc mã truy cập đã hết hạn, bị thu hồi hoặc không hợp lệ. Lấy mã truy cập mới.

Nếu có mã phụ, hãy xem mã phụ đó.

1

API không xác định

Có thể là sự cố tạm thời do thời gian chết. Hãy đợi và thử thực hiện lại thao tác. Nếu vẫn gặp sự cố, hãy kiểm tra để chắc chắn bạn đang yêu cầu một API có sẵn.

2

Dịch vụ API

Sự cố tạm thời do thời gian chết. Hãy đợi và thử thực hiện lại thao tác.

3

Phương thức API

Vấn đề về tính năng hoặc quyền. Đảm bảo ứng dụng của bạn có chức năng hoặc quyền cần thiết để thực hiện lệnh gọi này.

4

Quá nhiều lệnh gọi API

Sự cố tạm thời do giới hạn tốc độ. Hãy đợi và thử thực hiện lại thao tác hoặc kiểm tra số lượng yêu cầu API của bạn.

17

Quá nhiều lệnh gọi người dùng API

Sự cố tạm thời do giới hạn tốc độ. Hãy đợi và thử thực hiện lại thao tác hoặc kiểm tra số lượng yêu cầu API của bạn.

10

Quyền API bị từ chối

Quyền không được cấp hoặc đã bị gỡ. Xử lý quyền bị thiếu.

190

Mã truy cập đã hết hạn

Lấy mã truy cập mới.

200-299

Quyền API (Nhiều giá trị tùy thuộc vào quyền)

Quyền không được cấp hoặc đã bị gỡ. Xử lý quyền bị thiếu.

341

Đã đạt đến giới hạn ứng dụng

Sự cố tạm thời do giới hạn tốc độ hoặc thời gian chết. Hãy đợi và thử thực hiện lại thao tác hoặc kiểm tra số lượng yêu cầu API của bạn.

368

Tạm thời bị chặn vì vi phạm chính sách

Hãy đợi và thử thực hiện lại thao tác.

506

Bài viết trùng lặp

Không thể đăng bài viết trùng lặp liên tiếp. Hãy thay đổi nội dung của bài viết và thử lại.

1609005

Liên kết đăng bị lỗi

Đã xảy ra sự cố khi trích xuất dữ liệu từ liên kết cho sẵn. Kiểm tra URL và thử lại.

Mã phụ của lỗi xác thực

Mã Tên Việc cần làm

458

Ứng dụng không được cài đặt

Người dùng chưa đăng nhập vào ứng dụng của bạn. Xác thực lại người dùng.

459

Đã tạo điểm kiểm tra cho người dùng

Người dùng cần đăng nhập tại https://www.facebook.com hoặc https://m.facebook.com để khắc phục sự cố.

460

Đã thay đổi mật khẩu

Trên iOS 6 trở lên, nếu người dùng đã đăng nhập bằng quy trình tích hợp với hệ điều hành, hãy chuyển họ đến phần cài đặt hệ điều hành của Facebook trên thiết bị để cập nhật mật khẩu. Nếu không, họ phải đăng nhập lại vào ứng dụng.

463

Đã hết hạn

Trạng thái đăng nhập hoặc mã truy cập đã hết hạn, bị thu hồi hoặc không hợp lệ. Xử lý mã truy cập đã hết hạn.

464

Người dùng chưa xác nhận

Người dùng cần đăng nhập tại https://www.facebook.com hoặc https://m.facebook.com để khắc phục sự cố.

467

Mã truy cập không hợp lệ

Mã truy cập đã hết hạn, bị thu hồi hoặc không hợp lệ. Xử lý mã truy cập đã hết hạn.

492

Phiên không hợp lệ

Người dùng liên kết với mã truy cập Trang không có vai trò thích hợp trên Trang này.

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

Hãy truy cập hướng dẫn về Giới hạn tốc độ của API Đồ thị để biết thêm thông tin về Mã lỗi giới hạn tốc độ.