;
首页 接口文档 门票

门票

提供全国15000多家景点信息查询、门票预订服务。覆盖全国1~5A级景点信息。通过门票分销API接口,无界开放给磐河数据用户,从而实现红利共享,帮助企业快速打造属于自己的OTA(在线旅游)平台

http://接口域名/ticket/searchScenicList
json
get
http://接口域名/ticket/searchScenicList?appKey=您申请的APPKEY&keyWord=上海&PageIndex=1&PageSize=10

根据查询关键词搜索景点

请求参数:

参数名称 类型 必填 说明
keyWord string 查询关键词(会根据景点名称、景点位置、景点主题标签等模糊搜索)
pageIndex int 页码
pageSize int 页大小(取值范围[1-50])
cityName string 城市名称
provinceName string 省份名称
country string 国家名称
themeGroup string 景点主题(如动物园、植物园、博物馆、农场,展览等主题,多个英文逗号分隔:如:动物园,植物园)
star [] 数组,支持多个(如[3,4,5]}),star取值范围[0-5]
longitude decimal 经度(高德坐标系)
latitude decimal 纬度(高德坐标系)
distanceRange int 查询附近距离,单位KM ,配合经纬度使用
sort int 排序类型:综合 = 0,好评优先 = 1, 距离近->远 = 2,景区星级由高到低 = 3
isExistAvailableSaleProduct int 是否存在可售产品(1存在,0不存在)

返回参数:

参数名称 类型 说明
count int 搜索条件匹配到的景点数量
scenicList ScenicInfo[] 景点信息列表
scenicId string 景点ID
scenicName string 景点名称
mainImage string 景点主图
cityName string 景点所在城市
provinceName string 景点所在省份
address string 景点地址
longitude decimal 经度(高德坐标系)
latitude decimal 纬度(高德坐标系)
star int 景区星级(最高5,即5A)
commentScore decimal 评分(满分5分,小数点后1位)
openTime string 开放时间
themeGroups string 主题标签(多个英文逗号分隔)
distance decimal 距离(当根据经纬度查询时才有值)
ticketProducts ticketProduct[] 门票产品列表
productId string 产品ID
productName string 产品名称
marketPrice string 产品门市价(空或0表示,暂无门市价)
settlePrice string 产品分销价(空或0表示,此产品暂不可销售)

JSON返回示例 :

{
  "data": {
    "count": 2,
    "scenicList": [
      {
        "scenicId": "12361",
        "scenicName": "上海野生动物园",
        "mainImage": "https://img.shpanhe.com/scenic/100j1h000001hkwyw2759.jpg",
        "cityName": "上海",
        "provinceName": "上海",
        "address": "上海市浦东新区南六公路178号",
        "longitude": 121.721460,
        "latitude": 31.055591,
        "star": 5,
        "commentScore": 4.7,
        "openTime": "3/1-6/30 09:00-17:00;7/1-8/31 09:00-20:00;9/1-11/30 09:00-17:00;12/1-2/28 09:00-16:30;   说明:车入区运行时间:\n3月-6月、9月-11月  9:15-16:30;\n7月-8月  9:15-18:00 ;\n12月-翌年2月 9:15-15:30。\n \n水域游船运行时间:\n3月-6月、9月-11月 9:15-16:30;\n7月-8月  9:15-19:30;\n12月-翌年2月  9:15-15:30。",
        "themeGroups": "动物园",
        "distance": null,
        "ticketProducts": [
          {
            "productId": "8193",
            "productName": "上海野生动物园门票学生票",
            "marketPrice": "0.00",
            "settlePrice": "82.50"
          },
          {
            "productId": "8206",
            "productName": "上海野生动物园门票老人票(65周岁(含)以上)",
            "marketPrice": "0.00",
            "settlePrice": "82.50"
          }
        ]
      },
      {
        "scenicId": "14873",
        "scenicName": "顾村公园东方鸟世界",
        "mainImage": "https://img.shpanhe.com/scenic/0102g120008ipaetk4D83.jpg",
        "cityName": "上海",
        "provinceName": "上海",
        "address": "上海市宝山区顾村镇沪太路4788号顾村公园三号门内",
        "longitude": 121.362903,
        "latitude": 31.335439,
        "star": 0,
        "commentScore": 4.6,
        "openTime": "全年 06:00-18:00;   说明:东方鸟世界:8:30-17:00",
        "themeGroups": "动物园",
        "distance": null,
        "ticketProducts": [
          
        ]
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}