Tổng quan:
Khi các tích hợp tùy chỉnh của bạn gặp phải giới hạn tỷ lệ hoặc vấn đề với token, bạn sẽ thấy các lỗi 429 hoặc 401. Bài viết này sẽ hướng dẫn cách chẩn đoán và khắc phục các lỗi này.
Quy trình thực hiện:
Kiểm tra nhật ký tích hợp của bạn để xem mã trạng thái HTTP:
429 Too Many Requests → bạn đang vượt quá giới hạn tỷ lệ.
401 Unauthorized → token API của bạn không hợp lệ hoặc đã hết hạn.
Đối với lỗi 429 (Tỷ lệ yêu cầu quá cao):
Triển khai exponential backoff (tái thử sau số giây trong Retry-After header).
Phân phối các yêu cầu đều đặn hơn (ví dụ: xuất khẩu nhỏ thay vì một lần xuất khẩu lớn).
Đối với lỗi 401 (Chưa được ủy quyền):
Kiểm tra token API của bạn dưới Profile → API Keys.
Nếu hết hạn, tạo một token mới và cập nhật tích hợp của bạn.
Kiểm tra bằng cách sử dụng một yêu cầu GET /api/v1/lead-contacts đơn giản trong Postman hoặc curl để xác định sự cố.
Mẹo & Thực hành tốt:
Lưu trữ các yêu cầu GET thường xuyên ở chế độ cache để giảm tải API.
Xoay vòng token API hàng quý và lưu trữ chúng trong một kho bảo mật (không phải mã nguồn).
Giám sát bảng điều khiển sử dụng (nếu có) để dự đoán khi bạn sẽ đạt giới hạn.
Khắc phục sự cố / Câu hỏi thường gặp:
Q: Lỗi 429 mặc dù đã phân bổ yêu cầu?
A: Bạn có thể đang sử dụng các script song song; kiểm tra tất cả các khách hàng sử dụng cùng một token.
Q: Lỗi 401 sau khi cập nhật token?
A: Đảm bảo bạn đã khởi động lại dịch vụ tích hợp với token mới.
Q: Mã lỗi không xác định?
A: Tham khảo tài liệu API của Laywork hoặc bật logging chi tiết để nhận phản hồi HTTP đầy đủ.