مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

لغو رزرو پرواز

رزرو را پیش از صدور بلیت باطل کنید.

POST/Air/AirCancel

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

این اندپوینت برای رزروی است که نگه داشته شده ولی بلیتش صادر نشده است (وضعیت 10). بعد از صدور بلیت، لغو دیگر ممکن نیست؛ در آن حالت بلیت را با استرداد برگردانید.

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

ندارد.

پارامترهای کوئری#

ندارد.

پارامترهای بدنه#

نامنوعالزامیتوضیح
SessionIdstringالزامیشناسهٔ نشست شما.
UniqueIdstringالزامیشناسهٔ رزروی که از رزرو گرفته‌اید.

درخواست#

curl -X POST https://api.simorghapi.com/api/Air/AirCancel \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "TP-2026-000512"
  }'
const res = await fetch("https://api.simorghapi.com/api/Air/AirCancel", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "TP-2026-000512"
  })
});

const data = await res.json();
import requests

res = requests.post(
    "https://api.simorghapi.com/api/Air/AirCancel",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "TP-2026-000512",
    },
)

data = res.json()

پاسخ#

فیلدنوعتوضیح
Successbooleanدر صورت موفقیت true.
UniqueIdstringشناسهٔ رزرو.
PaymentDeadlinestringمهلت به‌روزشده، در صورتی که رزرو باز بماند.
Category / Statusintegerدسته و وضعیت رزرو پس از فراخوانی.
CancelationPolicyChangebooleanآیا قوانین لغو تغییر کرده است.
CanExtendPaymentDeadlinebooleanآیا می‌توانید مهلت را تمدید کنید.
CancellationPoliciesarray of objectبازه‌های جریمهٔ قابل اعمال.
CancellationPolicyNoteEnstringتوضیح خوانای قوانین لغو.
Errorobjectدر صورت موفقیت null.
{
  "Success": true,
  "UniqueId": "TP-2026-000512",
  "PaymentDeadline": "2026-10-10T18:00:00",
  "Category": 10,
  "Status": 10,
  "CancelationPolicyChange": false,
  "CanExtendPaymentDeadline": true,
  "CancellationPolicies": [
    { "FromDate": "2026-09-20T00:00:00", "ToDate": "2026-10-10T00:00:00", "Amount": 0.00, "Currency": "USD" }
  ],
  "CancellationPolicyNoteEn": "Free cancellation until the payment deadline.",
  "CancellationPolicyNote": null,
  "Remarks": null,
  "Error": null
}

خطاها#

کدمعناراه‌حل
Err0103003رزرو پیدا نشد.UniqueId را بررسی کنید.
Err0103004رزرو در وضعیت فعلی‌اش قابل لغو نیست.برای رزروی که بلیتش صادر شده، به‌جای لغو از استرداد استفاده کنید.
Err0103005رزرو قبلاً لغو شده است.کاری لازم نیست.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.