رفتن به محتوای اصلی
سیمرغSimorgh API

وب‌سرویس پرواز

پروازهای سیستمی و چارتر داخلی و پروازهای خارجی را از چند تأمین‌کننده یک‌جا جست‌وجو کنید، قیمت را پیش از رزرو بازبینی کنید و بلیت را مستقیم از کیف پول‌تان صادر کنید؛ همه با یک قرارداد JSON.

دریافت کلید رایگانمستندات وب‌سرویس پرواز
چرخهٔ کامل در API
  1. ۱ جست‌وجو
  2. ۲ بازبینی
  3. ۳ رزرو
  4. ۴ صدور
  5. ۵ پیگیری

۱٬۰۰۰+

ایرلاین داخلی و خارجی

قابلیت‌ها

هر چیزی که برای فروش پرواز داخلی و خارجی لازم دارید

بدون منطق جداگانه برای هر تأمین‌کننده؛ یک قرارداد پاسخ، یک مدل خطا و یک چرخهٔ سفارش.

۰۱

جست‌وجوی جریانی

نتایج با Server-Sent Events همان لحظه که از هر تأمین‌کننده می‌رسند به کاربر نشان داده می‌شوند؛ دیگر منتظر کندترین منبع نمی‌مانید.

۰۲

بازبینی قیمت پیش از رزرو

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

۰۳

قوانین بار و استرداد

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

۰۴

چرخهٔ کامل پس از صدور

وضعیت سفارش، لغو، برآورد مبلغ استرداد و ثبت استرداد از همان API؛ بدون تماس تلفنی و پیگیری دستی.

۰۵

یک‌طرفه، رفت‌وبرگشت، چندمسیره

همهٔ انواع سفر با یک شکل درخواست: کافی است برای هر مسیر یک slice بفرستید.

۰۶

عملیات امن با Idempotency

درخواست‌های ثبت و صدور با کلید Idempotency-Key تکرارپذیرند؛ قطعی شبکه هرگز به صدور دوبارهٔ بلیت نمی‌رسد.

مسیرهای API

مسیرهای HAPI v3

همهٔ درخواست‌ها با توکن Bearer احراز می‌شوند و درخواست‌های ثبت و صدور کلید Idempotency-Key می‌پذیرند.

آدرس پایهhttps://api.simorghapi.com/v3/HAPI
متدمسیرکاربرد
POST/auth/tokensدریافت توکن دسترسی
GET/flights/placesجست‌وجوی شهر و فرودگاه
POST/flights/searchesجست‌وجوی پرواز
POST/flights/searches/streamجست‌وجوی جریانی (SSE)
GET/flights/offers/{id}بازبینی قیمت و موجودی
GET/flights/offers/{id}/conditionsقوانین نرخ، بار و استرداد
POST/flights/ordersثبت سفارش و رزرو
POST/flights/orders/{id}/ticketصدور بلیت
GET/flights/orders/{id}جزئیات و وضعیت سفارش
POST/flights/orders/{id}/cancellationلغو سفارش
GET/flights/orders/{id}/refundبرآورد مبلغ استرداد
POST/flights/orders/{id}/refundثبت درخواست استرداد

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

/flights/searches
curl -X POST https://api.simorghapi.com/v3/HAPI/flights/searches \
  -H "Authorization: Bearer $SIMORGH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "slices": [
      { "origin": "THR", "destination": "MHD", "departure_date": "2026-11-02" }
    ],
    "passengers": { "adults": 2, "children": 1 },
    "cabin_class": "economy"
  }'

نمونهٔ پاسخ

201 Created · application/json
{
  "object": "flight_search",
  "id": "srch_428713",
  "status": "completed",
  "offer_count": 64,
  "offers": [
    {
      "object": "flight_offer",
      "id": "ofr_U0lNT1JHSC0xMjM0",
      "validating_airline": "IR",
      "cabin_class": "economy",
      "total": { "amount": "48600000", "currency": "IRR" },
      "slices": [
        {
          "origin": "THR",
          "destination": "MHD",
          "segments": [{ "flight_number": "IR453", "stops": 0, "seats_remaining": 7 }]
        }
      ]
    }
  ]
}

همه‌چیز در سندباکس قابل امتحان است. همین درخواست‌ها را با کلید تست بفرستید؛ صدور شبیه‌سازی می‌شود.

راهنمای کامل
با همان کلید

محصولات دیگر را هم اضافه کنید

وب‌سرویس هتلجست‌وجوی شهری، نرخ اتاق، رزرو و تأییدوب‌سرویس تور و تفریحاتکاتالوگ، ظرفیت روزانه، رزرو و واچر
سؤال دارید؟

پرسش‌های وب‌سرویس پرواز

اگر جواب سؤال‌تان اینجا نیست، تیم ما در ساعات کاری پاسخ‌گوست.

با ما حرف بزنید۰۲۱-۹۱۳۰۲۱۵۸
تماس

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

امروز کلید سندباکس بگیرید، این هفته اولین جست‌وجو را بزنید.

ثبت‌نام رایگان است و تا وقتی صدوری نداشته باشید هزینه‌ای پرداخت نمی‌کنید.

دریافت کلید رایگانگفت‌وگو با فروش