واچرهای تفریحات

واچر یک رزرو تفریح صادرشده را دریافت و دانلود کنید.

واچر فقط پس از صدور رزرو وجود دارد. رزرو را آن‌قدر پیگیری (poll) کنید تا وضعیتش صادرشده شود، سپس واچرها را فهرست و دانلود کنید. SessionId را به‌صورت پارامتر کوئری بفرستید.

فهرست واچرها#

GET/Activity/v2/bookings/{uuid}/vouchers

دسترسی نیازمند مجوز activity_get_vouchers

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

پارامترهای مسیر#

نام	نوع	الزامی	توضیح
`uuid`	string	الزامی	مرجع رزرو.

curl "https://api.simorghapi.com/api/Activity/v2/bookings/1d59a17e-9726-4283-a5b7-bab7886e4709/vouchers?SessionId=8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"

const uuid = "1d59a17e-9726-4283-a5b7-bab7886e4709";
const res = await fetch(`https://api.simorghapi.com/api/Activity/v2/bookings/${uuid}/vouchers?SessionId=8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f`);
const data = await res.json();

import requests

uuid = "1d59a17e-9726-4283-a5b7-bab7886e4709"
res = requests.get(
    f"https://api.simorghapi.com/api/Activity/v2/bookings/{uuid}/vouchers",
    params={"SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"},
)

data = res.json()

پاسخ#

{
  "data": [
    {
      "uuid": "b7c1e2a4-5d6f-4a8b-9c0d-1e2f3a4b5c6d",
      "generatedAt": "2026-10-14T11:02:00.000+08:00",
      "visualId": "GBB-Z2KB84Z",
      "links": [
        { "method": "GET", "rel": "download", "href": "https://api.simorghapi.com/api/Activity/v2/bookings/1d59a17e-9726-4283-a5b7-bab7886e4709/download-voucher/b7c1e2a4-5d6f-4a8b-9c0d-1e2f3a4b5c6d" }
      ]
    }
  ],
  "timestamp": "2026-10-15T16:24:49.648+08:00"
}

دانلود واچر#

GET/Activity/v2/bookings/{uuid}/download-voucher/{voucher}

دسترسی نیازمند مجوز activity_get_vouchers

فایل واچر را با نوع application/pdf از طریق همین درگاه استریم می‌کند. uuid رزرو و uuid واچر را بفرستید.

curl -L -o voucher.pdf \
  "https://api.simorghapi.com/api/Activity/v2/bookings/1d59a17e-9726-4283-a5b7-bab7886e4709/download-voucher/b7c1e2a4-5d6f-4a8b-9c0d-1e2f3a4b5c6d?SessionId=8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f"

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

تا جای ممکن از پیگیری مکرر (polling) پرهیز کنید. به‌جای اینکه برای فهمیدن صدور، مدام رزرو را بخوانید، رویداد booking_status_updated را در اندپوینت وب‌هوک‌ها بخوانید.

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