مستندات وب‌سرویس تورهای Last Second

بررسی سلامت سرویس. نیاز به کلید ندارد.

نمونه درخواست

curl "https://tour.imagineit.online/wp-json/ls-provider/v1/health"

نمونه پاسخ

{
  "ok": true,
  "version": "1.2.4"
}

دریافت لیست تورها با فیلتر و صفحه‌بندی. بدون فیلتر، همه تورها (صفحه‌به‌صفحه) برگردانده می‌شوند.

در بدنهٔ پاسخ، min_price و max_price هر تور به‌صورت خودکار از کمترین و بیشترین مبلغ معتبر در tour_treks (trekهای داخلی از Last Second) و فیلدهای amount_* هتل‌های tour_hotels محاسبه می‌شوند. آرایهٔ tour_treks شامل هر بار/پکیج قابل رزرو (از treks/index و tours/show) است. پس از نصب/به‌روزرسانی افزونه، یک بار sync تور از پنل اجرا کنید تا trekها و مبالغ در پایگاه داده پر شوند. پارامترهای query با همین نام برای فیلتر بودجه روی min_price / max_price ذخیره‌شده در جدول تورها اعمال می‌شوند.

پارامترهای Query

انتخاب فیلدها (fields)

با fields یا preset=standard خروجی را دقیقاً به شکل نمونه زیر بگیرید (بدون tour_treks و min_price / max_price مگر اینکه خودتان بخواهید).

https://tour.imagineit.online/wp-json/ls-provider/v1/tours?per_page=5&preset=standard

https://tour.imagineit.online/wp-json/ls-provider/v1/tours?per_page=1&fields=tour_id,tour_type,tour_country,tour_city,tour_hotels,vehicle_type,shipping_company,origin_travel,source_travel,date_gone,time_gone,date_return,time_return,Length_stay,is_charter,services,documents,description

نمونه cURL

curl -H "X-LS-API-Key: YOUR_KEY" \
  "https://tour.imagineit.online/wp-json/ls-provider/v1/tours?city=استانبول&min_stars=4&page=1&per_page=20&fields=tour_id,tour_city,min_price"

نمونه JavaScript

fetch('https://tour.imagineit.online/wp-json/ls-provider/v1/tours?city=استانبول', {
  headers: { 'X-LS-API-Key': 'YOUR_KEY' }
})
  .then(r => r.json())
  .then(console.log);

نمونه پاسخ

{
  "success": true,
  "data": {
    "items": [
      {
        "tour_id": 1,
        "tour_type": "تور اروپا",
        "tour_country": "ترکیه",
        "tour_city": "استانبول",
        "tour_hotels": [
          {
            "hotel_id": 1,
            "hotel_name": "هتل شماره 1",
            "service_type": "صبحانه",
            "amount_2_beds": 10000000,
            "amount_child_with_bed": 5000000,
            "amount_1_beds": 7000000,
            "amount_child_without_bed": 3000000,
            "number_stars": 4,
            "hotel_images": ["https://yoursite.com/ht-img/a1b2c3d4e5f67890"]
          }
        ],
        "vehicle_type": "هواپیما",
        "shipping_company": "ماهان",
        "origin_travel": "فرودگاه امام خمینی",
        "source_travel": "فرودگاه استانبول",
        "date_gone": "1403-12-05",
        "time_gone": "12:30",
        "date_return": "1403-12-10",
        "time_return": "09:15",
        "Length_stay": "مدت 4 شب و 5 روز",
        "is_charter": 0,
        "services": "خدمات",
        "documents": "مدارک",
        "description": "توضیحات"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 150,
      "total_pages": 8
    }
  }
}

دریافت جزئیات یک تور با شناسه. ساختار پاسخ مانند لیست تورها است؛ شامل tour_treks و min_price / max_price محاسبه‌شده از trekها و هتل‌ها. پارامتر fields همانند لیست تورها پشتیبانی می‌شود.

نمونه درخواست

curl -H "X-LS-API-Key: YOUR_KEY" \
  "https://tour.imagineit.online/wp-json/ls-provider/v1/tours/1"

نمونه پاسخ

{
  "success": true,
  "data": { "...": "همان ساختار یک تور در لیست" }
}