Change Passenger Info

این متد جهت تغییر اطلاعات مسافران – مانند اسم، تاریخ تولد، شماره گذرنامه و … – استفاده می گردد.

کاربرد این متد زمانی است که شما مالک یک سایت و سیستم رزرواسیون سپهری هستید و می خواهید از طریق وب سرویس اطلاعات برخی از مسافران موجود در سیستم خود را تغییر دهید.

جهت استفاده از این متد لازم است که IP شما در سایت سپهری که قصد استفاده از این متد روی آن را دارید Trust شود. جهت Trust کردن IP، نیاز می باشد که مجموعه ای شما روی سربرگ رسمی IP را به مجموعه سپهر اعلام نماید. جهت دریافت نمونه درخواست، اینجا کلیک نمایید. همچنین برای تست می توانید از محیط تستی (سایت SepehrApiTest.ir) استفاده نمایید که تراست کردن IP بدون نیاز به طی مراحل رسمی و اداری امکان پذیر است. برای استفاده از محیط تست کافی است IP خود را از طریق واترآپ یا تلگرام به ما اعلام نمایید.

API Endpoint

https://{SupplierWebsiteUrl}/api/ThirdParties/ChangePassengerInfo/Change/V1 post

Request headers

لطفا دقت نموده که به همراه تمامی درخواست های خود، header های زیر را نیز ارسال نمایید.

Content-Type: application/json; charset=utf-8

required

استفاده از این Header مشخص می کند که فرمت درخواست شما json بوده و encoding که برای ارسال اطلاعات استفاده شده utf-8 می باشد.

Accept: application/json

required

استفاده از این Header به سرور سپهر اعلام می کند که باید جواب را به صورت json برگشت دهد.

Request Parameters

نمونه کلاس Request به زبان سی شارپ در پروژه ThirdParties.Contracts (دانلود) در پوشه زیر موجود است:

\ChangePassengerInfo\Change\V1\RequestModel

Username

string

required

نام کاربری

Password

string

required

رمز عبور به صورت MD5 شده

Pnr

string

required

رفرنس سیستم سپهر که بعد از فراخوانی متد Book دریافت نموده اید

PassengerList

Complex type

required

لیست مسافرانی که می خواهید اطلاعات آنان را تغییر دهید

TicketNumber

string

required

شماره بلیط که بعد از فراخوانی متد Book دریافت نموده اید و سپهر توسط این شماره بلیط، مسافر را پیدا کرده و اطلاعات آن را تغییر خواهد داد.

NewData

complex type

required

اطلاعات جدیدی که قصد دارید برای مسافر ثبت شود

Title

string

required

این فیلد مشخص کننده خانم یا آقا بودن مسافر می باشد که می تواند یکی از مقادیر MR یا MS را داشته باشد.

FirstName

string

required

نام جدید مسافر

LastName

string

required

نام خانوادگی جدید مسافر

Birthdate

string

required

تاریخ تولد جدید مسافر با فرمت yyyy-MM-dd به صورت میلادی.

IranianCartMelli

Complex type

optional/conditional

اطلاعات جدید مربوط به کد ملی مسافر.
در حالت هایی که مسافر ایرانی باشد و پرواز نیز داخلی باشد، باید مقدار این فیلد را پر نمایید. در غیر این صورت باید فیلد Passport را پر نمایید. در غیر این صورت سیستم درخواست شما را reject خواهد کرد.

CodeMelli

string

شماره کد ملی مسافر

Passport

Complex type

optional/conditional

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

Number

string

شماره گذرنامه مسافر

ExpiryDate

string

تارخ انقضا گذرنامه با فرمت yyyy-MM-dd و به صورت میلادی.

NationalityCountryCode

string

کد ISO دو حرفی یا سه حرفی ملیت مسافر

جهت مشاهده کد ISO کشور ها اینجا کلیک نمایید.

به عنوان مثال برای ایران می توانید یکی از مقدارهای IR یا IRN را وارد نمایید.

PlaceOfIssueCountryCode

string

کد ISO دو حرفی یا سه حرفی محل صدور گذرنامه مسافر

جهت مشاهده کد ISO کشور ها اینجا کلیک نمایید.

به عنوان مثال برای ایران می توانید یکی از مقدارهای IR یا IRN را وارد نمایید.

{
  "Username": "testdev1",
  "Password": "25f9e794323b453885f5181f1b624d0b",
  "Pnr": "RYD4T5",
  "PassengerList": [
    {
      "TicketNumber": "1529946",
      "NewData": {
        "Title": "MR",
        "FirstName": "SINA",
        "LastName": "MOHAMMADI",
        "Birthdate": "1984-05-28",
        "IranianCartMelli": {
          "CodeMelli": "0074564951"
        }
      }
    }
  ]
}

{
  "Username": "testdev1",
  "Password": "25f9e794323b453885f5181f1b624d0b",
  "Pnr": "RYD4T5",
  "PassengerList": [
    {
      "TicketNumber": "1529946",
      "NewData": {
        "Title": "MR",
        "FirstName": "SINA",
        "LastName": "MOHAMMADI",
        "Birthdate": "1984-05-28",
        "Passport": {
          "Number": "0074564951",
          "ExpiryDate": "2025-08-29",
          "NationalityCountryCode": "TR",
          "PlaceOfIssueCountryCode": "IR"
        }
      }
    }
 ]
}

Response Data

این متد در صورت موفقیت جوابی به صورت json برنمی گرداند و فقط Http Code شماره 200 برگشت داده خواهد شد.