Ticket Api

خرید و رزرواسیون بلیت

یک سال قبل بازدید 3

مهمترین بخش از api های ساتا، امکان رزرو و خرید بلیت تئاتر می باشد، برای انجام این موارد از api مربوط به بلیت ها تحت عنوان ApiTicket استفاده کنید

جهت اطلاعات یک بلیت از این api استفاده کنید

https://api.satha.ir/api/ApiTicket/GetTickets

ورودی های این api به شکل ذیل است:

{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketId": "string"
}

 

مقدار companyId برابر با مقدار Id کمپانی شما که در Response مربوط به api احراز هویت (ApiAccount/Login ) برای شما ارسال شده است

مقدار CompanySystemId از پنل مدیریتی، قسمت سامانه های فعال / توکن های دسترسی  قابل استفاده است.

مقدار companyAccessHash برابر با توکن ایجاد شده شما در پنل کاربری می باشد که از قسمت پنل مدیریتی ( سامانه های فعال / توکن های دسترسی )  در دسترس می باشد

مقدار ticketId برابر با کد یکتای بلیت می باشد که در لیست بلیت های یک تئاتر از طریق ApiTheater در دسترس می باشد.

نمونه درخواست ارسالی به شکل ذیل است:

curl -X 'POST' \
  'https://api.satha.ir/api/ApiTicket/GetTickets' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketId": "string"
}'

مقدار برگشتی api به شکل ذیل است:

{

  "responseCode": 0,
  "isSuccess": true,
  "message": "string",
  "data": {
    "id": "string",
    "theaterTicketId": "string",
    "seatTitle": "string",
    "rowTitle": "string",
    "groupTitle": "string",
    "planTitle": "string",
    "ticketPrice": 0,
    "ticketDiscount": 0,
    "ticketAddtional": 0,
    "isSold": true,
    "isLocked": true,
    "userCreator": "string",
    "isActive": true,
    "description": "string",
    "status": 0,
    "isDeleted": true,
    "companyId": "string",
    "samtaTheaterShowId": "string",
    "theaterId": "string",
    "title": "string"
  }
}

 

جهت رزرو بلیت از این api استفاده کنید:

https://api.satha.ir/api/ApiTicket/ReservationTicket

ورودی های این api به شکل ذیل است:

{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketId": "string",
  "isReserved": true,
  "ticketPrice": 0,
  "ticketDiscount": 0,
  "ticketAddtional": 0
}

مقدار companyId برابر با مقدار Id کمپانی شما که در Response مربوط به api احراز هویت (ApiAccount/Login ) برای شما ارسال شده است

مقدار CompanySystemId از پنل مدیریتی، قسمت سامانه های فعال / توکن های دسترسی  قابل استفاده است.

مقدار companyAccessHash برابر با توکن ایجاد شده شما در پنل کاربری می باشد که از قسمت پنل مدیریتی ( سامانه های فعال / توکن های دسترسی )  در دسترس می باشد

مقدار ticketId برابر با کد بلیت مدنظر جهت رزرو بلیت

مقدار isReserved جهت انجام رزرو بلیت که بصورت یک مقدار boolean است، در صورتی که می خواهید یک بلیت را از حالت رزرو خارج کنید، مقدار ارسالی را false ارسال نمایید و در صورت رزرو، مقدار true ارسال کنید

مقدار ticketPrice برابر با مقدار نهایی بلیت مد نظر. قیمت پایه توسط api برای شما ارسال می گردد. ( در صورتی که مبلغی کمتر یا بیشتر مدنظر شرکت است، قیمت جدید را ار وارد و ارسال کنید.

نمونه درخواست ارسالی به شکل ذیل است:

curl -X 'POST' \
  'https://api.satha.ir/api/ApiTicket/ReservationTicket' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketId": "string",
  "isReserved": true,
  "ticketPrice": 0,
  "ticketDiscount": 0,
  "ticketAddtional": 0
}'
مقدار برگشتی api به شکل ذیل است:
{
  "responseCode": 0,
  "isSuccess": true,
  "message": "string",
  "data": {
    "id": "string",
    "theaterTicketId": "string",
    "seatTitle": "string",
    "rowTitle": "string",
    "groupTitle": "string",
    "planTitle": "string",
    "ticketPrice": 0,
    "ticketDiscount": 0,
    "ticketAddtional": 0,
    "isSold": true,
    "isLocked": true,
    "userCreator": "string",
    "isActive": true,
    "description": "string",
    "status": 0,
    "isDeleted": true,
    "companyId": "string",
    "samtaTheaterShowId": "string",
    "theaterId": "string",
    "title": "string"
  }
}

جهت دریافت....

https://api.satha.ir/api/ApiTicket/ConfirmTicket

 

ورودی های این api به شکل ذیل است:

{

  "companyId": "string",

  "companySystemId": "string",

  "companyAccessHash": "string",

  "ticketBookerId": "string",

  "companyCustomerId": "string",

  "userBrowser": "string",

  "systemIp": "string",

  "ticketPrice": 0,

  "ticketDiscount": 0,

  "ticketAdditional": 0

}

}

 

مقدار companyId برابر با مقدار Id کمپانی شما که در Response مربوط به api احراز هویت (ApiAccount/Login ) برای شما ارسال شده است

مقدار CompanySystemId از پنل مدیریتی، قسمت سامانه های فعال / توکن های دسترسی  قابل استفاده است.

مقدار companyAccessHash برابر با توکن ایجاد شده شما در پنل کاربری می باشد که از قسمت پنل مدیریتی ( سامانه های فعال / توکن های دسترسی )  در دسترس می باشد

 

 

 

نمونه درخواست ارسالی به شکل ذیل است:

curl -X 'POST' \
  'https://api.satha.ir/api/ApiTicket/ConfirmTicket' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketBookerId": "string",
  "companyCustomerId": "string",
  "userBrowser": "string",
  "systemIp": "string",
  "ticketPrice": 0,
  "ticketDiscount": 0,
  "ticketAdditional": 0
}'

 

مقدار برگشتی api به شکل ذیل است:

{
  "responseCode": 0,
  "isSuccess": true,
  "message": "string",
  "data": "string"
}

 

جهت دریافت....

https://api.satha.ir/api/ApiTicket/CancelTicket

 

ورودی های این api به شکل ذیل است:

{

  "companyId": "string",

  "companySystemId": "string",

  "companyAccessHash": "string",

  "ticketBookerId": "string",

  "reasonForCancellation": "string",

  "userBrowser": "string",

  "systemIp": "string"

}

 

مقدار companyId برابر با مقدار Id کمپانی شما که در Response مربوط به api احراز هویت (ApiAccount/Login ) برای شما ارسال شده است

مقدار CompanySystemId از پنل مدیریتی، قسمت سامانه های فعال / توکن های دسترسی  قابل استفاده است.

مقدار companyAccessHash برابر با توکن ایجاد شده شما در پنل کاربری می باشد که از قسمت پنل مدیریتی ( سامانه های فعال / توکن های دسترسی )  در دسترس می باشد

 

نمونه درخواست ارسالی به شکل ذیل است:

curl -X 'POST' \
  'https://api.satha.ir/api/ApiTicket/ConfirmTicket' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "companyId": "string",
  "companySystemId": "string",
  "companyAccessHash": "string",
  "ticketBookerId": "string",
  "companyCustomerId": "string",
  "userBrowser": "string",
  "systemIp": "string",
  "ticketPrice": 0,
  "ticketDiscount": 0,
  "ticketAdditional": 0
}'

 

مقدار برگشتی api به شکل ذیل است:

{
  "responseCode": 0,
  "isSuccess": true,
  "message": "string",
  "data": "string"
}