/v1/orderĐặt mua nhiều dịch vụ
Tạo đơn và hoá đơn cho nhiều món một lần (gói dịch vụ, tên miền, chứng chỉ); thanh toán theo pay_method. Lỗi từng món trả HTTP 200 với error = ["item_error", {code, message, item}] (item: vị trí món trong items); gói hosting phải có domain. Cần cả orders:write và billing:write: thiếu một trong hai trả 403 insufficient_scope.
Gọi qua gateway https://api.tino.vn/v1 bằng token có quyền orders:write; xem Gọi API Tino.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token ứng dụng (tinoat_, Đăng nhập bằng Tino) hoặc token API cá nhân (tinopat_).
Scopes
orders:write
Tham số
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
pay_method | integer | Tuỳ chọn | Payment method ID |
ignore_errors | boolean | Tuỳ chọn | Process order even if some of the items were rejected due to errors |
items | array | Tuỳ chọn | list with order items |
aff_id | integer | Tuỳ chọn | Affiliate ID |
Phản hồi
Chưa có mẫu thật: route thay đổi dữ liệu thật hoặc tài khoản thử không có dữ liệu cho route này. Câu trả lời là một đối tượng JSON; lỗi theo dạng chung ở Gọi API Tino.
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
401 · invalid_token | Token sai, hết hạn hoặc đã bị thu hồi. |
403 · insufficient_scope | Token không có quyền orders:write. |
403 · ip_not_allowed | Token API cá nhân gọi từ IP ngoài danh sách giới hạn. |
Lỗi nghiệp vụ của route thường là HTTP 200 kèm {"error": ["<code>"]}; xem mã lỗi chung.