رزرو تور و تفریحات

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

پیش از شروع#

یک SessionId. بخش احراز هویت را ببینید.
مجوزهای تفریحات، از جمله activity_products_list، activity_price_lists، activity_create_booking و activity_get_vouchers.
یادتان باشد: SessionId را در درخواست‌های GET در کوئری‌استرینگ و در درخواست‌های POST و PUT در بدنه بفرستید.

قدم ۱: پیدا کردن محصول و نوع آن#

کاتالوگ را مرور کنید، یک محصول را باز کنید و انواع آن را فهرست کنید. productTypeUuid را نگه دارید.

curl "https://api.simorghapi.com/api/Activity/v2/products?city=Singapore&sort=bestselling&SessionId=8f3c81d2-..."

curl "https://api.simorghapi.com/api/Activity/v2/products/PRODUCT_UUID/product-types?SessionId=8f3c81d2-..."

قدم ۲: بررسی ظرفیت#

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

curl "https://api.simorghapi.com/api/Activity/v2/product-types/5f3ff236-40b1-4f0a-a780-1db8649d1f5b/price-lists?SessionId=8f3c81d2-..."

curl "https://api.simorghapi.com/api/Activity/v2/product-types/5f3ff236-40b1-4f0a-a780-1db8649d1f5b?date=2026-10-15&SessionId=8f3c81d2-..."

قدم ۳: ایجاد رزرو#

نوع محصول را برای تاریخ، ترکیب نفرات و مشتری اصلی رزرو کنید. یک uuid رزرو با وضعیت reserved دریافت می‌کنید؛ آن را نگه دارید.

curl -X POST https://api.simorghapi.com/api/Activity/v2/bookings \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-...",
    "productTypeUuid": "5f3ff236-40b1-4f0a-a780-1db8649d1f5b",
    "arrivalDate": "2026-10-15",
    "adults": 2,
    "customer": { "firstName": "Jane", "lastName": "Doe", "email": "traveller@example.com", "phone": "+441234567890" }
  }'

قدم ۴: تأیید#

با تأیید، رزرو به سمت صدور می‌رود. پلتفرم آن را به‌صورت ناهمگام صادر می‌کند.

curl -X PUT https://api.simorghapi.com/api/Activity/v2/bookings/BOOKING_UUID/confirm \
  -H "Content-Type: application/json" \
  -d '{ "SessionId": "8f3c81d2-..." }'

قدم ۵: دریافت واچر#

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

curl "https://api.simorghapi.com/api/Activity/v2/bookings/BOOKING_UUID/vouchers?SessionId=8f3c81d2-..."

curl -L -o voucher.pdf \
  "https://api.simorghapi.com/api/Activity/v2/bookings/BOOKING_UUID/download-voucher/VOUCHER_UUID?SessionId=8f3c81d2-..."

فهرست کامل فیلدها در صفحه‌های مرجع تفریحات آمده است.

ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.