# سیمرغ (Simorgh)

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

> Simorgh is a single travel API for Iranian travel agencies, OTAs, startups and developers: domestic and international flights (scheduled and charter), hotels, and tours/activities, with one contract and one prepaid toman wallet.

## Key facts

- Integration, sandbox and search are free. Fee: 1% of each successful issuance, capped at 500,000 toman per issuance.
- Minimum wallet top-up to go live: 50,000,000 toman. Optional consulting & support package, where the Simorgh team builds the integration for the customer: 990,000,000 toman.
- Coverage: 1,000+ airlines (18 Iranian domestic carriers), 5,000,000+ hotels, 2,500+ activities.
- API (HAPI v3): https://api.simorghapi.com/v3/HAPI — OAuth2 client-credentials bearer tokens, JSON, SSE streaming flight search, Idempotency-Key on write requests.
- Classic API: https://api.simorghapi.com/api. Sandbox: https://demo.simorghapi.com/api.
- Contact: info@simorghapi.com, +982191302158. Support hours: شنبه تا پنج‌شنبه، ۹ تا ۱۸.

## Products

- [وب‌سرویس پرواز](https://simorghapi.com/flights-api): وب‌سرویس پرواز سیمرغ: جست‌وجوی هم‌زمان پروازهای داخلی و خارجی، بازبینی قیمت، رزرو، صدور، لغو و استرداد بلیت با یک API و کیف پول تومانی. بیش از ۱٬۰۰۰ ایرلاین.
- [وب‌سرویس هتل](https://simorghapi.com/hotels-api): وب‌سرویس هتل سیمرغ: جست‌وجوی شهر و هتل، نرخ لحظه‌ای اتاق، نگه‌داری نرخ، رزرو، تأیید و لغو با یک API. دسترسی به ۵ میلیون هتل.
- [وب‌سرویس تور و تفریحات](https://simorghapi.com/activities-api): وب‌سرویس تور و تفریحات سیمرغ: کاتالوگ بیش از ۲٬۵۰۰ گشت، تور یک‌روزه و بلیت جاذبه با ظرفیت روزانه و سانس، رزرو، تأیید و دریافت واچر PDF.

## Pages

- [صفحهٔ اصلی / Home](https://simorghapi.com/)
- [تعرفه‌ها / Pricing](https://simorghapi.com/pricing)
- [تماس / Contact](https://simorghapi.com/contact)
- [OpenAPI](https://simorghapi.com/openapi.yaml)

## Documentation (HAPI v3)

- [شروع سریع HAPI v3](https://simorghapi.com/docs/get-started): در پنج دقیقه توکن دسترسی بگیرید و اولین درخواست احرازشده را به HAPI v3 بفرستید.
- [احراز هویت در HAPI v3](https://simorghapi.com/docs/authentication): احراز هویت در HAPI v3 با گرنت client-credentials در OAuth2 و ارسال توکن Bearer در همهٔ درخواست‌ها.
- [قراردادهای HAPI v3](https://simorghapi.com/docs/conventions): قواعد مشترک HAPI v3: شناسهٔ منابع، مبالغ، زمان‌ها، شناسهٔ درخواست و ایدمپوتنسی.
- [خطاهای HAPI v3](https://simorghapi.com/docs/errors): HAPI v3 خطاها را چگونه گزارش می‌کند: کدهای وضعیت واقعی HTTP و یک شیء خطای نوع‌دار.
- [محیط تست و عملیاتی](https://simorghapi.com/docs/environments): محیط سندباکس (تست) و عملیاتی در HAPI v3 چگونه کار می‌کنند و چطور با اعتبارنامه انتخاب می‌شوند.
- [درخواست‌های ایدمپوتنت](https://simorghapi.com/docs/idempotency): تکرار امن درخواست‌های ایجاد با هدر Idempotency-Key.
- [صفحه‌بندی](https://simorghapi.com/docs/pagination): پیمایش اندپوینت‌های فهرستی با کرسر.
- [محدودیت نرخ درخواست](https://simorghapi.com/docs/rate-limits): محدودیت تعداد درخواست و هدرهایی که سهمیهٔ باقی‌ماندهٔ شما را گزارش می‌کنند.
- [کیف پول و موجودی](https://simorghapi.com/docs/wallet): خواندن موجودی قابل‌استفادهٔ کیف پول دفتر شما.
- [نسخه‌بندی](https://simorghapi.com/docs/versioning): نسخه‌بندی HAPI چگونه است.
- [API جست‌وجوی پرواز](https://simorghapi.com/docs/flights/search): جست‌وجوی پرواز را با مسیرها، مسافران و کلاس کابین بسازید و پیشنهادهای قیمت‌دار بگیرید.
- [دریافت استریمی نتایج جست‌وجوی پرواز](https://simorghapi.com/docs/flights/stream): پیشنهادهای پرواز را هم‌زمان با رسیدن، از طریق رویدادهای SSE دریافت کنید.
- [دریافت و اعتبارسنجی مجدد پیشنهاد پرواز](https://simorghapi.com/docs/flights/offers): پیش از رزرو، پیشنهاد را دوباره بخوانید و قیمتش را به‌روز کنید.
- [شرایط نرخ پرواز](https://simorghapi.com/docs/flights/conditions): قوانین نرخ، جریمه‌ها و بار مجاز یک پیشنهاد را بخوانید.
- [API رزرو پرواز](https://simorghapi.com/docs/flights/orders): از یک پیشنهاد سفارش بسازید و سپس بلیت صادر کنید، آن را بخوانید، لغو یا استرداد کنید و یادداشت بگذارید.
- [API جست‌وجوی مقصد هتل](https://simorghapi.com/docs/hotels/places): جست‌وجوی هم‌زمان با تایپ برای مقصدهای هتل: شهرها، محله‌ها و هتل‌ها.
- [API رزرو هتل](https://simorghapi.com/docs/hotels/search): جست‌وجوی موجودی و نرخ لحظه‌ای هتل‌ها برای یک مقصد و بازهٔ تاریخ.
- [تأیید نرخ هتل](https://simorghapi.com/docs/hotels/rates): پیش از رزرو، قیمت نرخ را به‌روز و آن را تأیید کنید.
- [API رزرو اتاق هتل](https://simorghapi.com/docs/hotels/orders): از یک نرخ سفارش هتل بسازید و سپس آن را تأیید کنید، بخوانید، لغو کنید یا مهلتش را تمدید کنید.
- [API تورها و تفریحات](https://simorghapi.com/docs/activities/products): کاتالوگ تورها، جاذبه‌ها و تجربه‌های گردشگری را مرور کنید.
- [ظرفیت و قیمت تفریحات](https://simorghapi.com/docs/activities/availability): تاریخ‌های قابل‌رزرو، سانس‌ها و قیمت هر مسافر را برای یک تفریح بخوانید.
- [API رزرو تفریحات](https://simorghapi.com/docs/activities/bookings): رزرو تفریحات را ایجاد، تأیید، مشاهده و لغو کنید.
- [واچر تفریحات](https://simorghapi.com/docs/activities/vouchers): واچر یک رزرو تأییدشدهٔ تفریحی را دریافت و دانلود کنید.