POST/v1/tickets

Tạo ticket

Tạo ticket hỗ trợ mới. Trả số ticket ở trường ticket (không phải ticket_number), ví dụ {"ticket": 886174}; dùng số này làm @number ở các route ticket khác.

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 tickets: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

tickets:writeTạo và trả lời ticket

Tham số

Body (JSON)

Tên	Kiểu	Yêu cầu	Mô tả
`dept_id`	integer	Tuỳ chọn	Department id
`subject`	string	Tuỳ chọn	Ticket subject
`body`	string	Tuỳ chọn	Ticket message

Phản hồi

Câu trả lời JSON của route, giữ nguyên dạng của UserAPI (Dữ liệu cá nhân). Mẫu thật từ tài khoản thử, đã che dữ liệu cá nhân; mảng và chuỗi dài được rút gọn (… N more item(s), … N more line(s)).

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 tickets: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.