دموی زنده

API رزرو کشتی

API کشتی برای آژانس‌ها و OTAها: حرکت‌ها، خودروها و بلیت

API کشتی به وب‌سایت شما اجازه می‌دهد حرکت‌های واقعی بین بنادر را نشان دهد و بلیت را در همان بازدید بفروشد. این صفحه توضیح می‌دهد API کشتی چه چیزی برمی‌گرداند، چرا رزرو کشتی فقط به نام و تاریخ بسنده نمی‌کند، بلیت و پذیرش چگونه کار می‌کنند و PHPTRAVELS چگونه اتصال به کشتی را به موتور رزرو روی دامنهٔ خودتان تبدیل می‌کند.

  • برنامه حرکت و ظرفیت
  • خودرو، کابین و حیوان خانگی
  • بلیت الکترونیکی و پذیرش
  • سفر جزیره‌به‌جزیره

چیست

API کشتی شبکه‌ای از بنادر را توصیف می‌کند، نه فهرستی از محصولات

پروازها کد فرودگاه دارند و هتل‌ها آدرس. کشتی‌ها بندر دارند، مسیرهای بین آن‌ها و اپراتورهایی که هر مسیر را در روزهای مشخص می‌پیمایند. API کشتی اول این شبکه را نشان می‌دهد و بعد حرکت‌های روی آن را.

مسیر نمونه

  1. پیرائوسبندر خشکیمرحله ۱ · چند اپراتور
  2. ناکسوسجزیرهٔ مرکزیمرحله ۲ · حرکت‌های فصلی
  3. سانتورینیجزیره
  • 01بنادر

    ایستگاه‌هایی که مسافران مبدأ و مقصد جستجوی خود قرار می‌دهند، با نام بندر و کشور. بعضی شهرها بیش از یک ترمینال دارند، پس API بندر دقیق را برمی‌گرداند.

  • 02مسیرها

    خطوطی که دو بندر را به هم وصل می‌کنند. فرم جستجوی شما فقط جفت‌هایی را پیشنهاد می‌دهد که یک اپراتور متصل واقعاً در آن‌ها حرکت دارد، پس مسافر هرگز مسیر ناموجود را جستجو نمی‌کند.

  • 03حرکت‌ها

    حرکت‌های تاریخ‌دار هر مسیر، با کشتی، ساعت‌ها و جای باقی‌مانده. این بخشی است که هر دقیقه تغییر می‌کند.

خط مسیری که یک بندر خشکی را به دو جزیره وصل می‌کند و حرکت‌های کشتی، خودروها و بلیت‌ها بین پلتفرم رزرو و اپراتورها رد و بدل می‌شوند

در پشت صحنه، ماژول کشتی شبکه را در یک جا نگه می‌دارد: مسیرهای اپراتورهای متصل کنار مسیرهایی که خودتان بارگذاری می‌کنید قرار می‌گیرند و خطوطی که بندر مشترک دارند به سفرهای طولانی‌تر وصل می‌شوند. طرز کار را در صفحهٔ کشتی ببینید.

برنامه حرکت و ظرفیت

دو فراخوانی تابلوی حرکت‌ها را پر می‌کنند

جستجوی کشتی در واقع دو پرسش است: چه حرکت‌هایی در این مسیر و تاریخ هست و آیا برای این مسافران و این خودرو هنوز جا مانده است. تأمین‌کنندگان این دو را جداگانه پاسخ می‌دهند و سایت شما پیش از نمایش قیمت به هر دو نیاز دارد.

حرکت‌ها · پیرائوسجمعه ۱۴ نوامبر
حرکتمقصدکشتیمدت عبورظرفیت
07:00ناکسوسکشتی سریع3 ساعت و 35 دقیقهدر حال فروشفقط صندلی، بدون خودرو
07:25ناکسوسکشتی رو-پکس5 ساعت و 40 دقیقهدر حال فروشصندلی و جای خودرو
07:30میکونوسکشتی رو-پکس5 ساعت و 15 دقیقهآخرین جاهاصندلی و جای خودرو
13:00پاروسکاتاماران3 ساعت و 10 دقیقهدر حال فروشفقط صندلی، بدون خودرو
17:30سانتورینیکشتی رو-پکس7 ساعت و 50 دقیقهآخرین جاهاآخرین کابین‌ها
21:00هراکلیونکشتی کروز9 ساعت و 00 دقیقهتکمیلنزدیک‌ترین حرکت قابل ارائه

داده‌های نمونه، ساده‌شده

  1. برنامه حرکت

    کدام حرکت‌ها برقرارند

    مسیر، تاریخ و بازهٔ زمانی ورودی است؛ حرکت، ورود، کشتی و مدت عبور خروجی. برنامه‌ها با فصل تغییر می‌کنند، پس زنده خوانده یا پیوسته به‌روز می‌شوند و هرگز دستی وارد نمی‌شوند.

  2. ظرفیت

    آیا در کشتی جا هست

    جای عرشه، صندلی، کابین و خط خودرو ظرفیت‌های جداگانه‌اند. ممکن است حرکتی صندلی خالی داشته باشد و جای خودرو نه، پس بررسی برای همان گروه و همان خودرو انجام می‌شود.

  3. قیمت

    این گروه چقدر می‌پردازد

    نرخ به نوع مسافر، کلاس انتخابی در کشتی و اندازهٔ خودرو بستگی دارد. درست پیش از پرداخت دوباره قیمت‌گذاری می‌شود، چون ممکن است آخرین کابین فروخته شده باشد.

تفاوت کشتی با بقیه

رزرو کشتی آدم‌ها، خودروها و جای خواب را با هم دارد

یک ایرلاین به نام و تاریخ نیاز دارد. اپراتور کشتی علاوه بر آن می‌خواهد بداند چه کسی در کدام گروه سنی سفر می‌کند، چه چیزی روی عرشهٔ خودرو می‌رود، همه کجا می‌نشینند یا می‌خوابند و آیا حیوانی همراه است. هر پاسخ قیمت و جای باقی‌مانده را تغییر می‌دهد.

پیرائوس ← ناکسوس · جمعه ۱۴ نوامبر · ۰۷:۲۵چرا API به آن نیاز دارد

01مسافران بر حسب نوع

  • بزرگسال2
  • کودک1
  • نوزاد0
  • سالمند0

اپراتورها برای بزرگسال، کودک، نوزاد و سالمند قیمت متفاوت دارند و هرکدام محدودهٔ سنی خود را تعیین می‌کنند. بعضی مسیرها نرخ ساکنان یا دانشجویان هم دارند. API به شما می‌گوید هر مسیر کدام انواع را می‌پذیرد.

02خودرو

سواریموتورسیکلتکمپر
طول
تا ۵ متر
ارتفاع
کمتر از ۲ متر

جای خودرو بر اساس نوع و اندازه فروخته می‌شود. طول مشخص می‌کند خودرو چقدر از خط را اشغال می‌کند؛ ارتفاع مهم است چون خودروهای بلند مثل کمپر و ون ممکن است به عرشهٔ دیگری نیاز داشته باشند. ابعاد نادرست ممکن است در بندر هزینهٔ اضافه داشته باشد.

03در کشتی

  • عرشهنشستن آزاد
  • صندلی رزروشدهشماره‌دار
  • کابینتخت، به‌ازای هر کابین

جای عرشه، صندلی رزروشده و کابین کلاس‌های جداگانه با ظرفیت خودشان هستند. صندلی به‌ازای هر مسافر قیمت‌گذاری می‌شود و کابین معمولاً به‌ازای هر کابین، که در سفرهای شبانه اهمیت دارد.

04حیوان خانگی

۱ سگ، در باکس حمل

قوانین بسته به اپراتور و کشتی فرق می‌کند: باکس حمل، کابین‌های مجاز برای حیوان یا اصلاً هیچ. حیوان خانگی یک خدمت اضافه با قیمت جدا و جای محدود است، پس همراه بلیت رزرو می‌شود.

جمع کل برای این گروه–عوارض و هزینه‌های بندری شامل می‌شود

فرم نمونه، ساده‌شده

بعد از رزرو

صدور بلیت و پذیرش

فروش کشتی با پرداخت تمام نمی‌شود. مسافر هنوز باید سوار شود، برنامه‌ها عوض می‌شوند و دریا هم حرف خودش را دارد. این بخش‌ها را API کشتی و پلتفرم شما با هم انجام می‌دهند.

  • بلیت الکترونیکی

    بسیاری از اپراتورها بلیت الکترونیکی با کد قابل اسکن صادر می‌کنند که مسافر روی گوشی یا کاغذ نشان می‌دهد. پلتفرم آن را همراه فاکتور ایمیل می‌کند و در حساب مشتری نگه می‌دارد.

  • سوار شدن در بندر

    در بعضی مسیرها هنوز شماره رزرو در دفتر اپراتور در بندر با کارت سوار شدن عوض می‌شود. تأییدیهٔ رزرو به مسافر می‌گوید کدام حالت برقرار است و کجا باید برود.

  • مهلت پذیرش

    خودروها معمولاً زودتر از مسافران پیاده پذیرش می‌شوند و مسیرهای بین‌المللی گذرنامه می‌خواهند. فروش آنلاین در مهلت پذیرش همان مسیر متوقف می‌شود.

  • تغییرات

    تغییر تاریخ، ساعت، مسافر یا خودرو از شرایط نرخ پیروی می‌کند و ممکن است کارمزد یا اختلاف قیمت داشته باشد. پس از تغییر، بلیت دوباره صادر می‌شود.

  • لغو به‌دلیل آب‌وهوا

    اپراتورها حرکت‌ها را به‌دلیل آب‌وهوا و وضعیت دریا لغو یا به تأخیر می‌اندازند. از پیش تعیین کنید مسافران متأثر چگونه مطلع و به حرکت بعدی منتقل یا طبق شرایط اپراتور بازپرداخت شوند.

  • لغو و بازپرداخت

    هر نرخ قانون بازپرداخت خودش را دارد. آن را پیش از پرداخت نشان دهید تا مسافر بداند چه خریده و بازپرداخت را از همان روش پرداخت اولیه انجام دهید.

اپراتورها شرایط خودشان را منتشر می‌کنند؛ پلتفرم آن را کنار هر حرکت نشان می‌دهد. ببینید نرم‌افزار رزرو فری این کار را برای اپراتورها و آژانس‌ها چگونه انجام می‌دهد.

آماده در PHPTRAVELS

کانکتورهای کشتی که با حساب خودتان فعال می‌کنید

این تأمین‌کنندگان کشتی از قبل به ماژول کشتی PHPTRAVELS وصل هستند. با تأمین‌کننده توافق می‌کنید، اطلاعات ورود خود را در پنل مدیریت وارد می‌کنید و حرکت‌هایش در جستجوی شما ظاهر می‌شود. فهرست به‌صورت زنده از فهرست یکپارچه‌سازی‌های ما می‌آید.

راه‌های دیگر برای پر کردن تابلو

  • سهمیه: صندلی، کابین و جای خودرویی که اپراتور به شما اختصاص می‌دهد و با تمام شدن، فروشش متوقف می‌شود.
  • مسیرهای خودتان: عبورهایی که خودتان اجرا یا قرارداد می‌کنید، با برنامه و نرخ خودتان.
  • API اپراتور کشتی دیگر: هر API مستند را می‌توان اضافه کرد و کد منبع مال شماست. یکپارچه‌سازی API سفارشی را ببینید.

سفر جزیره‌به‌جزیره

چند مرحله، یک سفر، یک پرداخت

سفر به جزایر به‌ندرت یک عبور است. مسافر با هواپیما می‌رسد، به بندر منتقل می‌شود، به یک جزیره می‌رود و بعد به جزیرهٔ بعدی. ترکیب این مراحل جایی است که API کشتی داخل یک پلتفرم رزرو کامل ارزشش را نشان می‌دهد.

  • بررسی اتصالهر مرحله فقط پس از رسیدن مرحلهٔ قبل و با حداقل فاصله‌ای که شما تعیین می‌کنید شروع می‌شود، پس هیچ سفری اتصال غیرممکن ندارد.
  • یک پرداختهر مرحله می‌تواند از اپراتور و منبع متفاوتی باشد، اما مشتری یک‌بار می‌پردازد و برای هر مرحله بلیت می‌گیرد.
  • اطلاعات منتقل می‌شودمسافران و خودرو از مرحله‌ای به مرحلهٔ بعد می‌روند و کسی یک اطلاعات را دو بار وارد نمی‌کند.

مرحلهٔ پرواز را با اتصال API پرواز و مسیر بندر را با فناوری ترانسفر فرودگاهی اضافه کنید. همه کنار APIهای سفر دیگر در یک پلتفرم قرار دارند.

  1. پرواز به آتنمرحلهٔ پرواز، از هر تأمین‌کنندهٔ پروازی که وصل می‌کنید.
  2. فرودگاه تا پیرائوسترانسفر از فرودگاه به ترمینال کشتی.
  3. پیرائوس ← ناکسوساولین عبور، با خودرو و دو بزرگسال در کشتی.
  4. ۳ شب در ناکسوساقامت در هتل بین دو عبور.
  5. ناکسوس ← سانتورینیعبور دوم، احتمالاً با اپراتور دیگر.

API کشتی را روی سایت خودتان به کار بگیرید

در دموی زنده حرکت‌ها را جستجو و یک عبور را رزرو کنید، سپس بگویید قصد فروش کدام مسیرها و اپراتورها را دارید.

اپلیکیشن‌های خودتان را می‌سازید؟ REST API و وب‌هوک‌ها با طرح Enterprise ارائه می‌شود. قیمت‌ها را مقایسه کنید یا مستندات توسعه‌دهنده را بخوانید.

پرسش‌های متداول

API کشتی: پرسش‌های آژانس‌ها

گفتگو با فروش

API کشتی مجموعه‌ای از وب‌سرویس‌های یک اپراتور کشتی یا پلتفرم رزرو کشتی است که به یک وب‌سایت مسافرتی اجازه می‌دهد بنادر، مسیرها و برنامه حرکت را بخواند، ظرفیت را برای مسافران و خودروها بررسی کند، رزرو بسازد و بلیت‌ها را در لحظه دریافت کند.

رزرو کشتی خودروهایی را اضافه می‌کند که بر اساس نوع و اندازه قیمت‌گذاری می‌شوند، کلاس‌های داخل کشتی مثل جای عرشه، صندلی و کابین، و حیوان خانگی. ظرفیت هرکدام جداگانه شمرده می‌شود و مهلت پذیرش برای مسافران پیاده و خودروها فرق دارد.

بله، اگر اپراتور در آن حرکت خودرو حمل کند. رزرو نوع و ابعاد خودرو را می‌فرستد و نرخ شامل جای آن روی عرشهٔ خودرو است.

بله، وقتی کشتی کابین داشته باشد. کابین یک کلاس جداگانه با ظرفیت خودش است و معمولاً به‌جای هر مسافر، به‌ازای هر کابین قیمت‌گذاری می‌شود.

تأمین‌کنندگان کشتی نمایش‌داده‌شده در این صفحه از فهرست زندهٔ یکپارچه‌سازی‌های ما می‌آیند. PHPTRAVELS شریک رسمی فناوری Kikoto Ferries است و اپراتورهای دیگر را می‌توان با یکپارچه‌سازی سفارشی اضافه کرد.

خیر. شما با هر تأمین‌کنندهٔ کشتی توافق می‌کنید و اطلاعات ورود خودتان را در پنل مدیریت وارد می‌کنید. PHPTRAVELS پلتفرم رزرو و کانکتورهای آماده را ارائه می‌دهد.

بله. مشتریان مرحله‌ها را یکی‌یکی اضافه می‌کنند، هر مرحله با رسیدن مرحلهٔ قبل سنجیده می‌شود و کل سفر در یک پرداخت انجام می‌شود، با بلیتی برای هر مرحله.

بله. مسیرهایی که خودتان اجرا یا قرارداد می‌کنید، سهمیه‌های اپراتورها و حرکت‌های API در همان جستجو ظاهر می‌شوند، هرکدام با نرخ و مارکاپ خودشان.

بله. نمایندگان B2B در پورتال نمایندگان شما با مارکاپ یا کمیسیون خودشان رزرو می‌کنند و از موجودی کیف پولشان می‌پردازند، روی همان نصبی که وب‌سایت عمومی شما را اجرا می‌کند.