# Tạo giỏ hàng

`POST /v1/carts` · quyền `orders:write`

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ỏ.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/v1/carts` |
| Method | `POST` |
| Quyền (scope) | `orders:write` |
| Header | `Authorization: Bearer <token>` |
| Content-Type | `application/json` |
| Token gọi được | token ứng dụng (`tinoat_`), token API cá nhân (`tinopat_`) |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `items` | body | array | — | Món theo định dạng POST /quote (product; domain đăng ký/chuyển) |

## Example request

```bash
curl -X POST "https://api.tino.vn/v1/carts" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "items": "<items>"
}'
```

`$TINO_TOKEN` là token có quyền `orders:write`.

SDK ([SDK & Ví dụ](/docs/sdk)): chưa có hàm riêng, dùng `client.request("POST", "/carts")`.

## Example response

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](/docs/api#loi).