- 1xx: Informational - Truyền tải thông tin ở tầng giao thức chuyển.
- 2xx: Success - Request đã thành công.
- 3xx: Redirection - Client phải thực hiện thêm hành động để hoàn tất request.
- 4xx: Client Error - Request thất bại do lỗi từ client.
- 5xx: Server Error - Request thất bại do lỗi từ server.
200 Success
Một request đã được thực hiện thành công.400 Bad Request
Lỗi400 Bad Request nghĩa là server không thể tiếp tục xử lý request. Nguyên nhân phổ biến nhất của lỗi này là cú pháp sai trong URL hoặc body của request.
401 Unauthorized
Các lỗi401 Unauthorized thường do vấn đề trong header của request khi bạn gọi API, ví dụ như bạn không dùng API key hợp lệ để gọi API.
403 Access Denied
Khi ứng dụng của bạn gọi API bằng API key và request không được phép. Lỗi 403 cũng có thể được trả về nếu User Profile đã bị đình chỉ.404 Resource Not Found
Lỗi này xảy ra khi ứng dụng của bạn cố gọi một API hoặc lấy một entity không tồn tại.405 Method Not Allowed
Lỗi này chỉ ra rằng các phương thức của giao thức HTTP trong request của bạn không được hỗ trợ. Kiểm tra tài liệu API để xem các phương thức được hỗ trợ.429 Rate Limit
Giới hạn tốc độ User Profile
Mỗi User Profile có giới hạn 300 request API trong khoảng 5 phút. Bạn có thể theo dõi việc sử dụng giới hạn tốc độ qua các response header:x-ratelimit-max: Hiển thị số request tối đa được phép trong khoảng 5 phútx-ratelimit-count: Hiển thị số request bạn đã thực hiện trong khoảng 5 phút hiện tại
Chúng tôi khuyến nghị bạn nên kiểm tra các phản hồi mã lỗi 429. Nếu thấy lỗi 429, tức là bạn đã đạt đến giới hạn
tốc độ. Các nỗ lực liên tục vượt quá giới hạn tốc độ có thể dẫn đến việc User Profile bị đình chỉ.Tìm hiểu thêm về xử lý giới hạn tốc độ cho nhiều user profile.
Giới hạn tốc độ analytics theo nền tảng
HTTP429 cũng có thể được trả về khi một mạng xã hội giới hạn các lệnh gọi analytics cho một tài khoản cụ thể — độc lập với giới hạn User Profile của Ayrshare. Trong trường hợp đó, phản hồi mang theo mã lỗi Ayrshare cụ thể của nền tảng (ví dụ code: 444 cho giới hạn analytics per-Page của Facebook). Kiểm tra trường code để phân biệt giới hạn ở cấp profile với giới hạn ở phía nền tảng, và hãy thử lại với backoff thay vì yêu cầu người dùng liên kết lại.
Giới hạn tốc độ khi xoá User Profile
Bạn có thể xoá 8 user profile mỗi giây. Vui lòng giãn cách các lệnh gọi API nếu cần xoá hàng loạt.Chính sách bảo vệ và đình chỉ do vượt giới hạn tốc độ
Để bảo vệ tính toàn vẹn của hệ thống, chúng tôi triển khai đình chỉ tự động nếu một User Profile vượt quá giới hạn tốc độ quá thường xuyên. Cách hoạt động như sau: Khi thực hiện các request API, bạn phải quản lý cẩn thận khung thời gian 5 phút. Ví dụ, nếu bạn thực hiện 300 request trong một phút, bạn sẽ cần đợi thêm bốn phút nữa trước khi thực hiện thêm request. Bất kỳ request nào trong khoảng thời gian chờ này sẽ kích hoạt phản hồi lỗi429.
Nếu một User Profile tích luỹ 1.000 vi phạm giới hạn tốc độ (lỗi 429) trong vòng 24 giờ, profile sẽ tự động bị đình chỉ.
Sau khi hết thời gian chờ 5 phút, bạn có thể tiếp tục thực hiện request lên tới giới hạn tiêu chuẩn 300 mỗi khoảng 5 phút.
500 Internal Server Error
Lỗi500 Internal Server Error cho biết Ayrshare đang gặp lỗi nội bộ hoặc quá trình xử lý đã thất bại.