Xử lý lỗi API và thử lại
Chẩn đoán lỗi xác thực, phạm vi, truy cập mô hình và khả dụng của ShareAI mà không ghi đè trùng lặp hoặc thử lại làm mới không an toàn.
Trên trang này
Luôn kiểm tra trạng thái HTTP trước khi đọc phản hồi là thành công. Các dịch vụ ShareAI có thể trả về các phong bì lỗi khác nhau: suy luận có thể cung cấp error.code, OAuth cung cấp error và error_description, và các tuyến Console có thể trả về code, message và data.status.
| Trạng thái | Ý nghĩa điển hình | Khôi phục |
|---|---|---|
| 200 với một đối tượng lỗi | Kết quả không có thiết bị khả dụng trong điểm cuối trò chuyện hiện tại. | Kiểm tra error.code và không hiển thị nó dưới dạng câu trả lời của trợ lý. |
| 400 | Yêu cầu không hợp lệ hoặc cấp quyền OAuth. | Sửa nội dung, tham số, callback hoặc mã đã hết hạn/đã sử dụng. |
| 401 | Thiếu, hết hạn hoặc xác thực không hợp lệ. | Kiểm tra thông tin xác thực; chỉ làm mới một OAuth grant hợp lệ. |
| 402 | Không đủ tín dụng hoặc số dư áp dụng. | Kiểm tra số dư tài khoản đã chọn trước khi thử lại. |
| 403 | Từ chối phạm vi, quyền sở hữu, vai trò hoặc trạng thái kích hoạt. | Kiểm tra ranh giới quyền được ghi nhận. |
| 404 | Tài nguyên không xác định hoặc tuyến cổng không được hỗ trợ. | Kiểm tra máy chủ, đường dẫn và định danh tài nguyên. |
| 409 | Xung đột trạng thái hoặc phiên bản. | Đọc trạng thái hiện tại và cân nhắc lại thay đổi. |
| 429 | Giới hạn yêu cầu hoặc đồng thời. | Tuân thủ Retry-After và sử dụng backoff có giới hạn. |
| 500 / 502 / 503 | Lỗi khả dụng của máy chủ hoặc upstream. | Giữ số lần thử lại trong giới hạn; bảo toàn định danh chẩn đoán. |
Thử lại đọc với giới hạn#
Đối với lỗi tạm thời khi đọc, chờ với độ trễ và dao động tăng dần, tuân thủ Retry-After nếu có và dừng sau số lần thử hoặc thời gian được xác định. Hiển thị cho người dùng khi dữ liệu không khả dụng thay vì lặp lại một cách im lặng.
Xử lý ghi cẩn thận#
Không tự động lặp lại cập nhật giá, tạo mô hình hoặc lệnh chia sẻ khi kết quả không xác định. Đọc trạng thái tài nguyên hoặc lệnh trước. Chỉ sử dụng Idempotency-Key trên các endpoint có tài liệu hỗ trợ, chẳng hạn như thay đổi thỏa thuận.
Token làm mới là sử dụng một lần#
Làm mới vòng quay cần khóa theo từng ủy quyền trong backend của bạn. Một lần thử lại mù của token làm mới đã sử dụng có thể thu hồi quyền cấp. Xem làm mới token an toàn.
Những gì cần bao gồm trong yêu cầu hỗ trợ#
Bao gồm endpoint, trạng thái HTTP, mã lỗi, thời gian và định danh phản hồi/nhiệm vụ nếu có. Loại bỏ các tiêu đề Authorization, cookie, bí mật khách hàng, access token, refresh token và nội dung prompt riêng tư.
Cập nhật lần cuối Tháng 9 15, 2026