Trip.com Hotel API v1.0

Thống kê hiện tại

https://thuvien.tourkitweb.vn/api.php

Thêm mới hoặc cập nhật hotel. Check trùng bằng hotel_id - nếu đã tồn tại sẽ cập nhật, chưa có sẽ thêm mới. Chỉ ghi đè field có giá trị (không xóa data cũ nếu field mới rỗng).

Xác thực (bắt buộc)

Push yêu cầu API key. Gửi bằng 1 trong 3 cách:

Cấu hình key trong file .env trên server: API_KEY=your-secret-key

Push 1 hotel

{
  "hotel_id": "3911317",          // Bắt buộc - Trip.com hotel ID
  "csvName": "Sai Gon Rach Gia",  // Tên trong file CSV
  "csvCode": "HTC123456",          // Mã trong file CSV
  "tripTitle": "Khách Sạn Sài Gòn Rạch Giá",
  "hotelData": {                        // JSON đầy đủ từ extension
    "hotelBaseInfo": { ... },
    "hotelDescriptionInfo": { ... },
    "hotelTopImage": { ... },
    "hotelPositionInfo": { ... },
    "hotelPopularFacility": { ... },
    "hotelPolicyInfo": { ... },
    "hotelComment": { ... },
    "seoSSRData": { ... },
    "baseFacilityInfo": { ... }
  }
}

Push batch (nhiều hotel)

{
  "hotels": [
    { "hotel_id": "3911317", "hotelData": { ... } },
    { "hotel_id": "1234567", "hotelData": { ... } }
  ]
}

Response

{
  "status": "success",
  "message": "Inserted: 1, Updated: 0",
  "inserted": 1,
  "updated": 0,
  "total_processed": 1
}

cURL ví dụ

curl -X POST "https://thuvien.tourkitweb.vn/api.php?action=push" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-key" \
  -d '{"hotel_id":"3911317","tripTitle":"Khách Sạn Sài Gòn Rạch Giá","hotelData":{...}}'

JavaScript ví dụ

const res = await fetch("https://thuvien.tourkitweb.vn/api.php?action=push", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "your-secret-key"
  },
  body: JSON.stringify({
    hotel_id: "3911317",
    csvName: "Sai Gon Rach Gia",
    tripTitle: "Khách Sạn Sài Gòn Rạch Giá",
    hotelData: { /* full JSON from extension */ }
  })
});
const data = await res.json();

Ví dụ

// Khách sạn 5 sao tại Đà Nẵng
GET /api.php?action=get&city=Đà Nẵng&star=5&limit=10

// Tất cả, full JSON data
GET /api.php?action=get&fields=full&limit=5

// Sắp xếp theo điểm đánh giá cao nhất
GET /api.php?action=get&sort=score&order=DESC

Trả về toàn bộ thông tin bao gồm full JSON data (mô tả, hình ảnh, vị trí, tiện ích, đánh giá...).

Response

{
  "status": "success",
  "hotel": {
    "hotel_id": "3911317",
    "trip_title": "Khách Sạn Sài Gòn Rạch Giá",
    "name_en": "Sai Gon Rach Gia Hotel",
    "star_level": 4,
    "city_name": "P. An Hoà",
    "province_name": "An Giang",
    "address": "844 Nguyễn Trung Trực, P. An Hoà",
    "description": "Khách sạn Sài Gòn Rạch Giá...",
    "score": "7.9",
    "total_reviews": 55,
    "image_url": "https://...",
    "images_json": [ "url1", "url2", ... ],
    "base_info_json": { /* hotelBaseInfo gốc */ },
    "description_json": { /* mô tả chi tiết */ },
    "position_json": { /* vị trí, bản đồ, POI */ },
    "facility_json": { /* tiện ích */ },
    "policy_json": { /* chính sách */ },
    "comment_json": { /* đánh giá */ },
    "full_json": { /* toàn bộ JSON gốc */ }
  }
}

Tìm theo tên (tiếng Việt, tiếng Anh), tên CSV, mã Hotelia, hoặc địa chỉ.

Tìm hotel theo mã Hotelia (csv_code). Ưu tiên: khớp chính xác → tìm theo hotel_id → tìm gần đúng. Trả về full data.

Ví dụ

// Tìm theo mã Hotelia
GET /api.php?action=lookup&code=HTC1754273094000691

// Tìm theo Trip.com ID
GET /api.php?action=lookup&code=3911317

Trả về tổng số hotel, phân bổ theo tỉnh, số sao, quốc gia.