文档中心 > API类目 > 电影票API

taobao.film.koubei.recommend.get (口碑-为你定制-数据召回查询)

口碑-为你定制-数据召回查询API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id String 可选 208812341234 用户ID
account_type String 可选 ALIPAY 账号类型
device_id String 可选 123456 设备ID
source String 必须 KOUBEI_ALIPAY 渠道来源
select_city_code Number 必须 310100 城市编码
longitude String 可选 123.1 经度
latitude String 可选 123.1 纬度
page_index Number 必须 1 分页页码
exclusion_show_ids String [] 可选 0
  • 最大列表长度:100
  • 排除的影片ID
    exclusion_cinema_ids String [] 可选 0
  • 最大列表长度:100
  • 排除的影院ID
    params Json 可选 扩展参数

    响应参数

    名称 类型 示例值 描述
    result ResultListModel 结果
    • └ return_url
    • String
    • returnUrl
    • └ return_code
    • String
    • 错误码
    • └ request_id
    • String
    • requestId
    • return_value_list
    • TopRecommendSearch []
    • 返回结果
    • tiny_cinema
    • TopTinyCinema
    • 影院信息
    • └ distance
    • String
    • 10.2
    • 距离
    • └ cinema_id
    • Number
    • 654321
    • 影院ID
    • └ cinema_name
    • String
    • 大光明影院
    • 影院名称
    • └ address
    • String
    • 日月光中心
    • 影院地址
    • └ min_trade_price
    • Number
    • 1800
    • 最低价格
    • └ display_supports
    • String []
    • 退票
    • 支持标签
    • └ activity_tag
    • String
    • 芳华等10部影片特惠
    • activityTag
    • └ min_trade_price_txt
    • String
    • 18元起
    • 最低价格文案
    • tiny_show
    • TopTinyShow
    • 影片信息
    • └ remark
    • String
    • 7.8
    • 评分
    • └ show_id
    • Number
    • 123456
    • 影片ID
    • └ show_name
    • String
    • 战狼2
    • 影片名称
    • └ sold_type
    • String
    • 热映
    • 热映/预售
    • └ poster
    • String
    • http://a.png
    • 影片图片
    • └ want_count
    • String
    • 1234
    • wantCount
    • └ min_trade_price
    • Number
    • 1800
    • 最低价格
    • └ display_supports
    • String []
    • 今日最热
    • 支持标签
    • └ min_trade_price_txt
    • String
    • 18元起
    • 价格文案
    • └ remark_count
    • String
    • 123400
    • 评分人数
    • └ leading_role
    • String
    • 锦泓,天禾
    • 核心演员
    • └ director
    • String
    • 锦泓
    • 导演
    • └ pic_url
    • String
    • http://a.png
    • 图片地址
    • └ biz_type
    • String
    • show
    • 业务类型
    • └ biz_name
    • String
    • 战狼2
    • 影片名称 & 影院名称
    • └ biz_id
    • Number
    • 1234
    • 影片ID & 影院ID
    • └ jump_url
    • String
    • http://a.com
    • 卡片的跳转地址
    • └ return_error_oper
    • String
    • returnErrorOper
    • └ return_error_solution
    • String
    • returnErrorSolution
    • └ return_message
    • String
    • returnMessage
    • └ return_error_stack_trace
    • String
    • returnErrorStackTrace

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FilmKoubeiRecommendGetRequest req = new FilmKoubeiRecommendGetRequest();
    req.setUserId("208812341234");
    req.setAccountType("ALIPAY");
    req.setDeviceId("123456");
    req.setSource("KOUBEI_ALIPAY");
    req.setSelectCityCode(310100L);
    req.setLongitude("123.1");
    req.setLatitude("123.1");
    req.setPageIndex(1L);
    req.setExclusionShowIds("0");
    req.setExclusionCinemaIds("0");
    req.setParamsString("");
    FilmKoubeiRecommendGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <film_koubei_recommend_get_response>
        <result>
            <return_url></return_url>
            <return_code></return_code>
            <request_id></request_id>
            <return_value_list>
                <top_recommend_search>
                    <tiny_cinema>
                        <distance>10.2</distance>
                        <cinema_id>654321</cinema_id>
                        <cinema_name>大光明影院</cinema_name>
                        <address>日月光中心</address>
                        <min_trade_price>1800</min_trade_price>
                        <display_supports>
                            <string>退票</string>
                        </display_supports>
                        <activity_tag>芳华等10部影片特惠</activity_tag>
                        <min_trade_price_txt>18元起</min_trade_price_txt>
                    </tiny_cinema>
                    <tiny_show>
                        <remark>7.8</remark>
                        <show_id>123456</show_id>
                        <show_name>战狼2</show_name>
                        <sold_type>热映</sold_type>
                        <poster>http://a.png</poster>
                        <want_count>1234</want_count>
                        <min_trade_price>1800</min_trade_price>
                        <display_supports>
                            <string>今日最热</string>
                        </display_supports>
                        <min_trade_price_txt>18元起</min_trade_price_txt>
                        <remark_count>123400</remark_count>
                        <leading_role>锦泓,天禾</leading_role>
                        <director>锦泓</director>
                    </tiny_show>
                    <pic_url>http://a.png</pic_url>
                    <biz_type>show</biz_type>
                    <biz_name>战狼2</biz_name>
                    <biz_id>1234</biz_id>
                    <jump_url>http://a.com</jump_url>
                </top_recommend_search>
            </return_value_list>
            <return_error_oper></return_error_oper>
            <return_error_solution></return_error_solution>
            <return_message></return_message>
            <return_error_stack_trace></return_error_stack_trace>
        </result>
    </film_koubei_recommend_get_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

    返回
    顶部