hkramble
  1. Booking
hkramble
  • Booking Flow
  • Booking
    • Search
      POST
    • Verify
      POST
    • Order
      POST
    • Pay
      POST
    • Confirm
      POST
    • SSR
      POST
    • OrderDetail
      POST
  • Change
    • ChangePricePush
      POST
    • ChangeResultPush
      POST
  • IssueNofity
    • IssueNotify
      POST
  1. Booking

Verify

POST
/json/verify
erroCode erroMsg Description
0 ok Request has been processed successfully.
S001 System error. System error.
B002 Partner does not exists. PartnerID does not exist.
B003 Illegal sign. Illegal sign. Please check your signature.
B035 Concurrency limited. Please contact TSYFare API support team for assistant. Concurrency exceeded system limits.
P001 XXX is illegal. The field of XXX is illegal.
P002 XXX is missing. The field of XXX is missing.
P004 The maximum number of passengers with seat is 9. Wrong parameter. The maximum number of passengers with seat is 9.
P005 There should be at least one adult. Wrong parameter. There should be at least one adult.
P009 The number of infant passengers can not exceed the number of adult passengers. Wrong parameter. The number of infant passengers can not exceed the number of adult passengers.
B013 Interface is limited, please contact the system administrator. The route that you request is limited, please contact system administrator.
B015 Pricing failed. Pricing failed for other reason.
B016 Flight near take-off, can’t offer pricing service. Pricing fail. Can not pricing for flights that is near taking off.
B018 Airline or flight restriction. Airline or flight restriction.
B019 Can not find any supplier for current search. Can not find any supplier for current search.
B020 Can not find any price for this flight. Pricing fail. Can not find any price for this flight option.
B021 The booking code you choose has only 0 seat available. Pricing fail. The booking code you choose has 0 seat left. Please choose other booking code or flight.
B026 LatestTktTime: yyyy-mm-dd hh : mm: ss. Last ticketing time is not enough to issue ticket.
B024 Pricing TimeOut. Pricing TimeOut.
B035 Concurrency limited. Please contact TSYFare API support team for assistant. Concurrent users control. Please contact TSYFare API support for assistant.
B039 Can't find the related data of XXX. Wrong parameter. Can't find the related data of XXX, like illegal city/country/area/airline.
B046 Interface is limited, the routing is offlined by TSYFare. Look to book control. If you need this routing, please contact TSYFare API for assistant.
B068 The segment detail is different between solutionid field and journey field. Please verify whether the information in the pricing request matches the details from the shopping response.
B121 Supplier is offline Supplier is not at working time, please contact TSYFare API support.

请求参数

Body 参数application/json

示例
{
    "authentication": {
        "partnerId": "11111111111111",
        "sign": "222222222222222"
    },
    "pricing": {
        "adults": 2,
        "cabin": "Y",
        "children": 0,
        "journeys": {
            "journey_0": [
                {
                    "airline": "VJ",
                    "arrival": "SGN",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "06:10",
                    "bookingCode": "U",
                    "departure": "TYO",
                    "departureDate": "2025-05-23",
                    "departureTime": "02:00",
                    "flightNum": "VJ821",
                    "segmentKey": "33b84e103ed240cb9d5a77115078d0e0"
                },
                {
                    "airline": "VJ",
                    "arrival": "DAD",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "15:55",
                    "bookingCode": "U",
                    "departure": "SGN",
                    "departureDate": "2025-05-23",
                    "departureTime": "14:35",
                    "flightNum": "VJ630",
                    "segmentKey": "267ec1a5b4594140b658d259b88ae314"
                }
            ]
        },
        "solutionId": "7211c63e30d9495b83b13b004605ee31|^_FHpev7qdqeCQD9Vom+CfiAvC35g/9A8fuBYQGzW2iRQR7Rgjw3GF+MvHpIE/ZEFdHdq/pSmVryAm5sHP9lZzCNKWzGTB7vuOLdqixjqrBuXjIXKgyUsccMCAGH/0SvB0KD6i+w04JXpL/JVRWGXSe7tc+3aYi1Jo3k7mqJRznH88hD1Rnd5VrpxgGPy11MG3IqXRgv+StR6nh3Px+VizmIt+Ogm5yUAtbUgnaTdH2gIuVzuPG5X4hhEsI7HKe9q3YGEBZaaBSi2xBZ6dwnOnz8RPAjVZzHUjvjoJ3ixVYDoE4y8zc4aSh7v4Dlx7Ztz8y1Yknryy4E5DvOPT8ikTtIgYElIpoJ/xmtTsjKgvh/Svp/pAcZ3M5GdxEcrcYQXfmObi+I8q2g8gdCgOPXBQRzi76a+NU9knwj/aJTxhn5nCzYNYS3iBCCtlVRYOy+qnub3lJCZZnFEsSvNXaVRMqFDYkd/D/WfUv8zFnlPab+QZzpWMTMUtFUEfOKWPcB4giGQToD0Q2pqyuQqsRIMkpJ2G3KItnyrcsUgzGi5SExo="
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/json/verify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authentication": {
        "partnerId": "11111111111111",
        "sign": "222222222222222"
    },
    "pricing": {
        "adults": 2,
        "cabin": "Y",
        "children": 0,
        "journeys": {
            "journey_0": [
                {
                    "airline": "VJ",
                    "arrival": "SGN",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "06:10",
                    "bookingCode": "U",
                    "departure": "TYO",
                    "departureDate": "2025-05-23",
                    "departureTime": "02:00",
                    "flightNum": "VJ821",
                    "segmentKey": "33b84e103ed240cb9d5a77115078d0e0"
                },
                {
                    "airline": "VJ",
                    "arrival": "DAD",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "15:55",
                    "bookingCode": "U",
                    "departure": "SGN",
                    "departureDate": "2025-05-23",
                    "departureTime": "14:35",
                    "flightNum": "VJ630",
                    "segmentKey": "267ec1a5b4594140b658d259b88ae314"
                }
            ]
        },
        "solutionId": "7211c63e30d9495b83b13b004605ee31|^_FHpev7qdqeCQD9Vom+CfiAvC35g/9A8fuBYQGzW2iRQR7Rgjw3GF+MvHpIE/ZEFdHdq/pSmVryAm5sHP9lZzCNKWzGTB7vuOLdqixjqrBuXjIXKgyUsccMCAGH/0SvB0KD6i+w04JXpL/JVRWGXSe7tc+3aYi1Jo3k7mqJRznH88hD1Rnd5VrpxgGPy11MG3IqXRgv+StR6nh3Px+VizmIt+Ogm5yUAtbUgnaTdH2gIuVzuPG5X4hhEsI7HKe9q3YGEBZaaBSi2xBZ6dwnOnz8RPAjVZzHUjvjoJ3ixVYDoE4y8zc4aSh7v4Dlx7Ztz8y1Yknryy4E5DvOPT8ikTtIgYElIpoJ/xmtTsjKgvh/Svp/pAcZ3M5GdxEcrcYQXfmObi+I8q2g8gdCgOPXBQRzi76a+NU9knwj/aJTxhn5nCzYNYS3iBCCtlVRYOy+qnub3lJCZZnFEsSvNXaVRMqFDYkd/D/WfUv8zFnlPab+QZzpWMTMUtFUEfOKWPcB4giGQToD0Q2pqyuQqsRIMkpJ2G3KItnyrcsUgzGi5SExo="
    }
}'

返回响应

🟢200Success
application/json
Body

示例
{
    "errorCode": "0",
    "errorMsg": "成功",
    "data": {
        "searchKey": null,
        "shoppingKey": "e7d6330bf9aa41779ded2843fd50838d",
        "solutions": [
            {
                "solutionKey": "N3a2IbJFNrUnbuInY3uAraue_v",
                "solutionId": "e7d6330bf9aa41779ded2843fd50838d|N3a2IbJFNrUnbuInY3uAraue_v",
                "fareType": "PRIVATE",
                "currency": "USD",
                "adtFare": 61.17,
                "adtTax": 48.29,
                "chdFare": 59.06,
                "chdTax": 48.29,
                "infFare": 0,
                "infTax": 0,
                "tktFee": 0,
                "platformServiceFee": 0,
                "comments": null,
                "journeys": {
                    "journey_0": [
                        "04647c0cc9444a8e8554d9c90ada673d"
                    ]
                },
                "fareRule": null,
                "rule": null,
                "platingCarrier": "BX",
                "prices": null,
                "merchantFee": 0,
                "adults": 1,
                "children": 0,
                "infants": 0,
                "baggageMap": {
                    "ADT": [
                        {
                            "segmentIndexList": [
                                1
                            ],
                            "baggageAmount": "1",
                            "baggageWeight": "15",
                            "carryOnAmount": "1",
                            "carryOnWeight": "10",
                            "carryOnSize": null
                        }
                    ]
                },
                "miniRuleMap": {
                    "ADT": {
                        "segmentIndex": [
                            1
                        ],
                        "miniRules": [
                            {
                                "penaltyType": 2,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 2,
                                "isPermited": 0,
                                "when": 1,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 0,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 0,
                                "isPermited": 0,
                                "when": 1,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            }
                        ]
                    },
                    "CHD": {
                        "segmentIndex": [
                            1
                        ],
                        "miniRules": [
                            {
                                "penaltyType": 2,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 2,
                                "isPermited": 0,
                                "when": 1,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 0,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            },
                            {
                                "penaltyType": 0,
                                "isPermited": 0,
                                "when": 1,
                                "noShowTime": null,
                                "noShowTimeUnit": null,
                                "amount": null,
                                "currencyCode": null,
                                "percent": null,
                                "baseType": null,
                                "originAmount": null,
                                "miniRuleAdjustAmount": null,
                                "miniRuleAdjustFlag": null,
                                "originCurrencyCode": null,
                                "guarantee": null
                            }
                        ]
                    }
                },
                "afterSaleRule": null,
                "qcharge": 0
            }
        ],
        "flights": [
            {
                "flightId": "04647c0cc9444a8e8554d9c90ada673d",
                "journeyTime": 405,
                "transferCount": 0,
                "lastTktTime": null,
                "segmengtIds": [
                    "2df08db36c1246598b80afb0aaaf190d"
                ]
            }
        ],
        "segments": [
            {
                "segmentId": "2df08db36c1246598b80afb0aaaf190d",
                "airline": "BX",
                "flightNum": "0747",
                "equipment": "A321",
                "cabinClass": "Economy",
                "bookingCode": "L",
                "availabilityCount": 1,
                "departure": "ICN",
                "arrival": "BKK",
                "departureTerminal": null,
                "arrivalTerminal": null,
                "departureDate": 1748510100000,
                "arrivalDate": 1748524800000,
                "flightTime": 405,
                "stayTime": null,
                "codeShare": null,
                "opFltNo": null,
                "opFltAirline": null,
                "stopover": null,
                "fareBasis": null,
                "strDepartureDate": "2025-05-29",
                "strDepartureTime": "17:15",
                "strArrivalDate": "2025-05-29",
                "strArrivalTime": "21:20"
            }
        ]
    }
}
修改于 2025-07-14 09:39:48
上一页
Search
下一页
Order
Built with