Lỗi xác thực dữ liệu

Thuộc tính	Giá trị
Loại lỗi	https://help.orderhi.com/partner-api/problems/validation-error
Trạng thái HTTP	422

Ý nghĩa

Yêu cầu là JSON hợp lệ nhưng nội dung không được chấp nhận. Chi tiết nằm trong errors, mỗi mục gồm tên trường (field) và thông báo (message).

Nguyên nhân thường gặp

• Thiếu một trường bắt buộc (ví dụ: items, customer.firstname, với DELIVERY là các trường địa chỉ).
• Mã tham chiếu không xác định (service_type_ref), hoặc payment_ref_id bị thiếu hay không phải là phương thức thanh toán của merchant.
• total_cents không khớp với tổng các mặt hàng, tùy chọn và phụ phí trừ đi giảm giá.
• requested_time nằm trong quá khứ hoặc xa hơn 7 ngày trong tương lai.
• Một giá trị có sai kiểu dữ liệu hoặc quá dài.

Cách khắc phục

• Đọc errors[].field và sửa trường được nêu.
• Kiểm tra các giá trị được phép tại mục "Referenzcodes" (mã tham chiếu) trong tài liệu API.
• Tính total_cents từ các mặt hàng, tùy chọn, phụ phí và giảm giá.

Phản hồi mẫu

Phản hồi có Content-Type là application/problem+json.

{
  "type": "https://help.orderhi.com/partner-api/problems/validation-error",
  "title": "Validation failed",
  "status": 422,
  "detail": "The order is invalid.",
  "errors": [
    {
      "field": "items[0].sku_ref",
      "message": "Required."
    },
    {
      "field": "total_cents",
      "message": "Must equal items + charges - discounts (2150)."
    }
  ]
}

Tất cả loại lỗi · English version