Superhostem.cz
Superhostem API v1

Tài liệu API công khai

Dùng API token của chủ nhà để chạy một số tự động hóa Superhostem từ backend hoặc công cụ nội bộ của bạn.

Tạo tài khoảnQuản lý API token
POST
/api/v1/calendars/sync
curl -X POST 'https://www.superhostem.cz/api/v1/calendars/sync' \
  -H 'x-api-key: sht_YOUR_TOKEN'
200

Tất cả lịch đã được đồng bộ thành công.

207

Một số lịch bị lỗi; hãy kiểm tra mảng results.

401

Token bị thiếu, hết hạn, bị thu hồi hoặc không hợp lệ.

Cách lấy API token cá nhân

  1. 1Đăng nhập Superhostem bằng tài khoản chủ nhà sẽ sở hữu tích hợp này.
  2. 2Mở Dashboard -> Cài đặt -> Hồ sơ và tìm phần API token.
  3. 3Tạo token, sao chép ngay lập tức và lưu vào nơi quản lý secret trên server hoặc công cụ tự động hóa.
Mở cài đặt API token

Điểm cuối

Phương thức
POST
Điểm cuối
/api/v1/calendars/sync
Nội dung yêu cầu
Không cần JSON body.

Phản hồi

{
  "ok": true,
  "syncedCalendars": 3,
  "propertiesChecked": 2,
  "failed": 0,
  "durationMs": 1842,
  "results": [
    {
      "propertyId": "...",
      "propertyName": "Căn hộ Praha",
      "source": "airbnb",
      "ok": true,
      "result": {
        "status": "success",
        "reservationsFound": 4,
        "reservationsCreated": 1,
        "reservationsUpdated": 3,
        "reservationsCancelled": 0
      }
    }
  ]
}

JavaScript

const response = await fetch('https://www.superhostem.cz/api/v1/calendars/sync', {
  method: 'POST',
  headers: {
    'x-api-key': 'sht_YOUR_TOKEN',
  },
});

const result = await response.json();
console.log(result);