文档中心 > API类目 > 旅行度假API

alitrip.travel.poisummary.query (口碑SUMMARY信息提供)

提供景点和酒店的summary信息服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
poi_ids PoiIds [] 可选
  • 最大列表长度:20
  • 查询poi入参数据
    • └ type
    • Number
    • 可选
    • 2
    • POI类型 0为酒店;2为景点
    • └ id
    • String
    • 可选
    • 1234
    • POI ID

    响应参数

    名称 类型 示例值 描述
    results PoiSummaryRsp [] 返回结果数据
    • └ id
    • Number
    • 123
    • POI ID
    • └ type
    • String
    • 0
    • POI类型 0为酒店;2为景点
    • └ pic
    • String
    • http://xxxx.jpg
    • 封面图
    • └ title
    • String
    • 环球影城
    • 标题
    • └ price
    • Number
    • 200
    • 价格
    • └ trade_valid
    • Boolean
    • true
    • 景点:是否可购买 ;酒店:是否可预订
    • └ notice
    • String
    • 预定须知
    • 须知
    • └ star
    • String
    • 5星级
    • 星级
    • └ hot_sale
    • String
    • 100
    • 热销提示
    • tag_infos
    • PoiTagInfo []
    • 标签
    • └ text
    • String
    • 111
    • 标签展示文案
    • └ icon
    • String
    • 111
    • 标签图标地址,有图标的优先展示图标
    • └ border_color
    • String
    • 111
    • 边框颜色
    • └ text_color
    • String
    • 111
    • 文字颜色
    • └ bg_color
    • String
    • 111
    • 背景颜色
    • └ h5_url
    • String
    • 111
    • h5Url 不带协议头
    • └ pc_url
    • String
    • 111
    • pcUrl 不带协议头
    is_success Boolean true isSuccess

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelPoisummaryQueryRequest req = new AlitripTravelPoisummaryQueryRequest();
    List<AlitripTravelPoisummaryQueryRequest.PoiIds> list2 = new ArrayList<AlitripTravelPoisummaryQueryRequest.PoiIds>();
    AlitripTravelPoisummaryQueryRequest.PoiIds obj3 = new AlitripTravelPoisummaryQueryRequest.PoiIds();
    list2.add(obj3);
    obj3.setType(2L);
    obj3.setId("1234");
    req.setPoiIds(list2);
    AlitripTravelPoisummaryQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_poisummary_query_response>
        <results>
            <poi_summary_rsp>
                <id>123</id>
                <type>0</type>
                <pic>http://xxxx.jpg</pic>
                <title>环球影城</title>
                <price>200</price>
                <trade_valid>true</trade_valid>
                <notice>预定须知</notice>
                <star>5星级</star>
                <hot_sale>100</hot_sale>
                <tag_infos>
                    <poi_tag_info>
                        <text>111</text>
                        <icon>111</icon>
                        <border_color>111</border_color>
                        <text_color>111</text_color>
                        <bg_color>111</bg_color>
                    </poi_tag_info>
                </tag_infos>
                <h5_url>111</h5_url>
                <pc_url>111</pc_url>
            </poi_summary_rsp>
        </results>
        <is_success>true</is_success>
    </alitrip_travel_poisummary_query_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部