huongnguyen
Danh sách API
Cập nhật lần cuối: 28/07/2026Lấy danh sách sản phẩm GET /api/v1/products Lấy danh sách sản phẩm. Request mẫu GET /api/v1/products?page=1&page_size=10&date=2026-05-01&get_packages=1 HTTP/1.1 Host: dev.vntix.vn Authorization: Bearer your_partner_token Tham số query Param Bắt buộc Mô tả page Không Mặc định 1 page_size Không Mặc định 20, tối đa 100 date Không Y-m-d, dùng cho logic giá nội bộ get_packages Không 1/true/yes/on sẽ nhúng...
Mã lỗi thường gặp
Cập nhật lần cuối: 28/07/2026Code HTTP Ý nghĩa AUTH_MISSING_TOKEN 401 Thiếu Authorization header AUTH_INVALID_TOKEN 401 Token không hợp lệ AUTH_PARTNER_SUSPENDED 403 Partner bị khóa AUTH_IP_BLOCKED 403 IP nằm trong blacklist AUTH_IP_NOT_ALLOWED 403 Không khớp whitelist PARTNER_AGENT_NOT_FOUND 422 Không có agent hợp lệ INVALID_JSON 400 Body không phải JSON hợp lệ VALIDATION_ERROR 400 Thiếu/sai field input PRODUCT_NOT_FOUND 404 Không tìm...
Cấu trúc dữ liệu
Cập nhật lần cuối: 28/07/2026Product item { "id": 123, "title": "Tên sản phẩm", "description": "...", "currency": "VND", "provider": "sun", "updated_at": 1760000000, "packages": [ ... ] } Package item { "id": 1, "title": "Gói 1", "description": "...", "include": "...", "exclude": "...", "terms_service": "...", "status": 1, "prices": [ ... ] } Price item { "id": 999, "from_date": 1760000000, "to_date": 1760600000, "exclude_dates":...
Khái niệm & luồng dữ liệu đặt vé
Cập nhật lần cuối: 28/07/2026Các trường dữ liệu cơ bản Để tích hợp đúng, đối tác cần hiểu mối quan hệ giữa product, package, price_rules và lines khi tạo booking. Product: là sản phẩm vé tham quan. Package: là gói bán cụ thể của sản phẩm, dùng package_id để đặt vé. Price period: mỗi package có các khoảng giá theo thời gian. Price rule: mỗi khoảng giá có nhiều dòng giá...
Xác thực
Cập nhật lần cuối: 28/07/2026Mọi request bắt buộc gửi Bearer token: Authorization: Bearer your_partner_token Các lỗi xác thực thường gặp: AUTH_MISSING_TOKEN (401) AUTH_INVALID_TOKEN (401) AUTH_PARTNER_SUSPENDED (403) AUTH_IP_BLOCKED / AUTH_IP_NOT_ALLOWED (403)
Tổng quan
Cập nhật lần cuối: 28/07/2026Base URL: https://dev.vntix.vn Content-Type: application/json Success envelope: { success: true, data: ..., meta: ... } Error envelope: { success: false, error: { code, message, details } }