Đọc toàn bộ phản hồi
Với trạng thái không thành công, hãy lưu mã HTTP, tiêu đề, nội dung lỗi và ID yêu cầu sau khi loại bỏ bí mật. Chúng giúp phân biệt yêu cầu không hợp lệ với việc từ chối truy cập hoặc sự cố tạm thời.
Không đưa phản hồi dịch vụ thô làm tin nhắn duy nhất cho người dùng: giải thích hành động trong khi vẫn giữ chi tiết chẩn đoán cho người vận hành.
Kiểm tra phản hồi lỗi
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Phân loại lỗi
- Lỗi 4xx thường yêu cầu sửa khóa, dữ liệu đầu vào hoặc quyền truy cập.
- Lỗi 429 đòi hỏi tôn trọng cửa sổ giới hạn và tránh thử lại dồn dập.
- Lỗi 5xx và lỗi mạng cần được thử lại có giới hạn với thời gian chờ tăng theo cấp số nhân và độ trễ ngẫu nhiên.
Thử lại an toàn
Chỉ thử lại lỗi tạm thời và chỉ khi thao tác có tính lũy đẳng trong sản phẩm. Với việc tạo nội dung, hãy giữ ID yêu cầu phía ứng dụng khách để tránh tính phí hai lần hoặc tạo tệp kết quả trùng lặp.
Khi phát trực tiếp, hãy phân biệt lỗi trước phần thay đổi đầu tiên với gián đoạn sau khi đã có một phần đầu ra: trường hợp sau không thể âm thầm được thay bằng phản hồi mới.