Lỗi API

Hãy lưu trạng thái HTTP, nội dung phản hồi, thời gian yêu cầu kèm múi giờ và ID mô hình. Thông báo “kết nối thất bại” đã được ứng dụng dịch là chưa đủ để chẩn đoán nguyên nhân.

400 Bad Request

JSON có thể không hợp lệ, thiếu trường bắt buộc, giá trị sai kiểu, mô hình từ chối tham số tùy chọn hoặc định dạng từ nhiều giao thức bị trộn lẫn. Hãy thử lại chỉ với các trường bắt buộc trong hướng dẫn đúng giao thức.

401 / 403 Xác thực hoặc quyền

Kiểm tra toàn bộ khóa không có khoảng trắng, header đúng giao thức, trạng thái và ngày hết hạn của khóa, số dư tài khoản và hạn mức khóa, khả năng tương thích nhóm-mô hình cùng giới hạn mô hình/IP.

404 URL, endpoint hoặc mô hình

Tìm /v1/v1, endpoint đầy đủ bị dán vào trường Base URL, ID mô hình bị sửa hoặc ứng dụng gửi nội dung của một giao thức tới đường dẫn của giao thức khác.

429 Too Many Requests

429 có thể là giới hạn tốc độ, giới hạn đồng thời hoặc nghẽn upstream. Dùng thời gian chờ tăng dần theo cấp số nhân kèm độ lệch ngẫu nhiên, tuân theo Retry-After khi có, giới hạn số lần thử lại đồng thời và đặt số lần thử cùng tổng thời gian tối đa. Không thử lại lỗi xác thực hoặc kiểm tra dữ liệu chắc chắn sẽ thất bại.

500 / 502 / 503 Lỗi dịch vụ

Trước tiên hãy xác minh yêu cầu tối thiểu. Yêu cầu văn bản không gây tác dụng phụ có thể được thử lại sau khoảng chờ ngắn. Không thử lại mọi lỗi 5xx vô hạn; tác vụ hình ảnh và quy trình công cụ có thể đã chạy hoặc phát sinh chi phí.

Hết thời gian chờ nhưng không có trạng thái HTTP

Kiểm tra DNS, TLS, proxy cục bộ, tường lửa, thời gian chờ của ứng dụng và bộ đệm phản hồi dạng luồng. Dùng curl trực tiếp trước khi gỡ lỗi một ứng dụng phức tạp.

Ghi báo cáo đã che thông tin theo mẫu:

Thời gian và múi giờ:
Ứng dụng và phiên bản:
Giao thức:
URL yêu cầu (không chứa khóa):
Mô hình:
Trạng thái HTTP:
Mã lỗi và thông báo trong phản hồi:
Có nhật ký Sprelay tương ứng: có / không

Mẫu này cố ý không yêu cầu khóa API và nội dung yêu cầu riêng tư.