orders.quote
POST/orders/quote
Báo giá một món với mã giảm giá cho tài khoản của key, chưa tạo đơn: giá gốc, số tiền giảm và số tiền phải trả. Cần key của một tài khoản đã xác minh email.
Tham số
| Tham số | Vị trí | Mô tả |
|---|---|---|
sku | body | Bắt buộc. Mã món cần mua, lấy từ prices.list: plan-1m, plan-3m, plan-12m cho gói trả trước, hoặc slug của guide bán lẻ. |
discountCode | body | Bắt buộc. Mã giảm giá cần kiểm tra, tối đa 32 ký tự. |
Yêu cầu
curl -X POST "https://api.modernengineer.dev/orders/quote" \
-H "Authorization: Bearer $SE_KEY" \
-H "Content-Type: application/json" \
-d '{"sku":"plan-3m","discountCode":"WELCOME10"}'Phản hồi
{
"sku": "plan-3m",
"listAmountVnd": 269000,
"amountVnd": 242100,
"discountVnd": 26900,
"discountCode": "WELCOME10"
}Lỗi
| Mã | Lỗi | Khi nào |
|---|---|---|
| 401 | unauthenticated | Thiếu API key, hoặc key không hợp lệ. Có kèm header WWW-Authenticate. |
| 403 | forbidden | Email của tài khoản chưa xác minh. |
| 400 | invalid_input | Tham số thiếu hoặc sai, ví dụ locale khác vi và en. |
| 404 | not_found | Không có món nào đang bán với sku này. |
| 409 | conflict | Bạn đã mua guide bán lẻ này rồi. |
| 422 | unprocessable | Mã giảm giá không áp dụng được. details.reason cho biết lý do: unknown, inactive, not_started, expired, wrong_item, already_used hoặc exhausted. |
| 429 | too_many_requests | Quá 30 lần báo giá trong một giờ cho tài khoản này. |