قفل، خرید و بررسی

• خرید آیتم جستجو شده – Book
• رزرو از طریق API
• سربرگ – Header
• مقادیر ارسالی – Request Data
• پاسخ صحیح – Response True
• پاسخ نادرست – Response False
• آخرین وضعیت آیتم خریداری شده – Book Status
• اطلاع از وضعیت رزرو از طریق API
• سربرگ – Header
• مقادیر ارسالی – Request Data
• پاسخ صحیح – Response True
• پاسخ نادرست – Response False
• قفل آیتم جستجو شده – Lock
• قفل آیتم از طریق API
• سربرگ – Header
• مقادیر ارسالی – Request Data
• پاسخ صحیح – Response True
• پاسخ نادرست – Response False
• لغو قفل انجام شده – Unlock
• لغو قفل آیتم از طریق API
• سربرگ – Header
• مقادیر ارسالی – Request Data
• پاسخ نادرست – Response False
• لیست خریدها – Book History (بزودی)
• بزودی…

خرید آیتم جستجو شده – Book

رزرو از طریق API

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

سربرگ – Header

{{Api Url}}/book

HEADER
POST /api/reservation/{{Api version}}/book HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Authorization: Bearer JWTToken
Domain: {{Your Domain}}

API Url از طریق پنل کاربری قابل مشاهده خواهد بود.

مقادیر ارسالی – Request Data

{
  "main_id": 10001,
  "items": [
    {
      "id": 10001,
      "lock_id": 20005,
      "local_pnr": "DFEfs213",
      "amount": 7, // Integer 
      "passengers": [
        {
          "gender": "male", //male , female
          "fullname": {
            "first_name": {
              "en": "", // first name en
              "fa": "" // first name fa
            },
            "last_name": {
              "en": "", // last name en 
              "fa": "" // last name fa 
            }
          },
          "identity": {
            "nationality": "IR",
            "id": "" // national code
          },
          "passport": {
            "id": false,
            "expire_at": false
          },
          "birth": "1994-05-14",
          "mobile": "", // phone number
          "email": false
        },
        ...
      ]
    },
    ...
  ]
}

پاسخ صحیح – Response True

جواب این api به صورت آرایه میباشد

{
    "items": [
        {
            "status": true,
            "pnr": {
                "local": "D0Efs213",
                "original": "htLQgDxD",
                "id": 10013
            }
        },
        {
            "status": false,
            "item_id": 10001,
            "code": 1006
        },
        ...
    ],
    "meta": {
      "timestamp": "Timestamp" // Timestamp    
    }
}

پاسخ نادرست – Response False

{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نمود اید.

آخرین وضعیت آیتم خریداری شده – Book Status

اطلاع از وضعیت رزرو از طریق API

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

سربرگ – Header

{{Api Url}}/book/status

HEADER
GET /api/reservation/{{Api version}}/book/status HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Authorization: Bearer JWTToken
Domain: {{Your Domain}}

API Url از طریق پنل کاربری قابل مشاهده خواهد بود.

مقادیر ارسالی – Request Data

{
  "local_pnr": ""
}

پاسخ صحیح – Response True

دریافت این پاسخ با Status Code 200 دریافت خواهد شد.

{
    "payload": {
        "status": "refund",
        "pnr": {
            "local": "",
            "original": "",
            "number": 10011
        },
        "refund": {
            "id": 10007
        }
    },
    "meta": {
        "timestamp": "Timestamp" // Timestamp
    }
}

پاسخ نادرست – Response False

{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نمود اید.

قفل آیتم جستجو شده – Lock

قفل آیتم از طریق API

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

سربرگ – Header

{{Api Url}}/lock

HEADER
POST /api/reservation/{{Api version}}/lock HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Authorization: Bearer JWTToken
Domain: {{Your Domain}}

API Url از طریق پنل کاربری قابل مشاهده خواهد بود.

مقادیر ارسالی – Request Data

{
  "charters": [
    {
      "id": 10002,
      "item_id": 10005,
      "passengers": {
        "adult": 2,
        "infant": 1
      }
    },
    ...
  ]
}

پاسخ صحیح – Response True

دریافت این پاسخ با Status Code 200 دریافت خواهد شد.

{
    "items": [
        {
            "id": 10001,
            "status": true,
            "lock_id": 20018,
            "duration": 5,
            "expiration": "2025-01-20 13:30:47"
        },
        {
            "id": 10002,
            "status": false,
            "code": 1002
        },
        ...
    ],
    "meta": {
        "timestamp": "Timestamp" // Timestamp
    }
}

پاسخ نادرست – Response False

{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نمود اید.

لغو قفل انجام شده – Unlock

لغو قفل آیتم از طریق API

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

سربرگ – Header

{{Api Url}}/unlock

HEADER
POST /api/reservation/{{Api version}}/unlock HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Authorization: Bearer JWTToken
Domain: {{Your Domain}}

API Url از طریق پنل کاربری قابل مشاهده خواهد بود.

مقادیر ارسالی – Request Data

{
    "lock_id": 20021
}

هنگامی که فرآیند لغو قفل رزرو با موفقیت انجام شود status code درخواست برابر با 204 خواهد بود و جوابی برای این api وجود ندارد.

پاسخ نادرست – Response False

{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نمود اید.

لیست خریدها – Book History (بزودی)

بزودی…