API công khai
Chẩn đoán 401, 403, 422 và 429
401 nghĩa là khóa hoàn toàn không được chấp nhận. 403 nghĩa là khóa được chấp nhận nhưng thao tác không được phép. 422 nghĩa là yêu cầu đã được hiểu và phần nội dung gửi lên bị sai. 429 nghĩa là bạn vượt giới hạn tần suất và nên chờ thay vì thử lại ngay.
Các bước
- Với 401, kiểm tra khóa có tồn tại, chưa hết hạn và được gửi trong đúng header bạn nghĩ — nguyên nhân thường gặp là dán bị cắt cụt.
- Với 403, đọc
code: thiếu phạm vi quyền, địa chỉ ngoài danh sách cho phép, hoặc khóa thuộc không gian làm việc khác. Kết nối lại không giúp được; cái phải đổi là quyền. - Với 422, đọc đúng trường mà phản hồi nêu tên rồi sửa phần nội dung gửi lên.
- Với 429, tôn trọng các header giới hạn tần suất và hãy chờ. Gửi lại ngay chỉ làm mọi thứ tệ hơn.
- Giữ lại
requestIdtrong phản hồi — đó là thứ giúp bộ phận hỗ trợ tìm đúng lần gọi của bạn.
Cách kiểm chứng kết quả
Cùng một yêu cầu thành công sau khi sửa, và phản hồi mang mã 2xx cùng đúng đối tượng bạn chờ đợi.
Chỗ thường sai
- Coi 403 là khóa hỏng rồi cấp lại khóa, việc chẳng thay đổi gì.
- Lặp lại một 429 trong vòng lặp dày.
- Gửi khóa cho bộ phận hỗ trợ thay vì id của yêu cầu.
Bài này có giải quyết được việc của bạn không?
Cách này không giúp được
Hãy viết cho chúng tôi kèm nền tảng và phiên bản, các bước bạn đã làm, kết quả mong đợi, cùng không gian làm việc hay mã QR liên quan. Che mọi thông tin bí mật trước khi đính kèm bất cứ thứ gì.
Viết cho bộ phận hỗ trợ