POST/v1/carts

Tạo giỏ hàng

Tạo giỏ của tài khoản (token gắn giỏ vào tài khoản), có thể kèm items, vat_info, aff_id. Trả uuid của giỏ.

API v1 · Cập nhật 21/10/2026Xem .md

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ả
`items`	array	—	Món theo định dạng POST /quote (product; domain đăng ký/chuyển)

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.