هر آنچه پیش از اولین درخواست به آن نیاز دارید: آدرس پایه، مدل احراز هویت، قواعد پاسخها و اینکه سرویسهای مستندشده چگونه در یک فرایند واقعی رزرو بلیت کنار هم قرار میگیرند.
بدنهی تمام درخواستها و پاسخها JSON است. تاریخها بهصورت محلی و بر اساس استاندارد ISO 8601 هستند، مانند 2026-07-20T09:30. بیشتر شناسهها عدد صحیح ساده هستند. دو استثنا وجود دارد، هر دو کد مبهم: کد سفر یک رشتهی حرفیعددی ۷ کاراکتری است مانند A3F92K7، و کد بلیت/رزرو یک رشتهی عددی ۸ رقمی است مانند 12345678. این دو در واقع در طول یک رزرو همان یک مقدار هستند — reserverTemporarily آن را بهعنوان ticketCode برمیگرداند و confirmReserve آن را بهعنوان reservationCode دریافت میکند. نام مکانها — استان، شهر و پایانه — دقیقاً به همان شکلی که در پایگاهداده شبکه ذخیره شدهاند، به فارسی بازگردانده میشوند.
هر یکپارچهسازی با همین گامها پیش میرود: اثبات هویت، جستوجوی مقصد، رزرو موقت صندلی و در نهایت صدور بلیت. هر مرحله در ادامه بهصورت یک صفحه مستقل مستند شده است؛ سرویسهای مدیریتی و دیباگ داخلی عمداً حذف شدهاند.
با کنار هم گذاشتن صفحات مرجع، این توالی دقیق فراخوانیهاست که یک مشتری را از جستوجو به یک بلیت پرداختشده میرساند.
یافتن سفر برنامهریزیشده و دریافت tripCode آن.
نگهداشتن موقت یک صندلی روی همان سفر.
افزودن اطلاعات مسافر و صدور بلیت.
استعلام یا لغو بلیت با کد آن.
.png)