taobao.film.open.ai.recommend.query (阿里影业电影演出导购外渠智能查询)

阿里影业电影演出导购外渠智能查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
guide_ai_query_param GuideAiQueryParam 可选 入参
  • └ user_info
  • String
  • 可选
  • {}
  • 用户信息
  • └ city_code
  • Number
  • 可选
  • 110100
  • 城市编码
  • └ utdid
  • String
  • 可选
  • utdid
  • 设备ID
  • └ page_size
  • Number
  • 可选
  • 10
  • 最大30
  • └ intent
  • String
  • 可选
  • GET_SHOW_LIST
  • 意图
  • └ intent_params
  • String
  • 可选
  • {}
  • 意图对应的参数
  • └ scene
  • String
  • 必须
  • show
  • 场景
  • └ outer_session_id
  • String
  • 可选
  • xxx
  • 外部会话ID
  • └ human_message
  • String
  • 可选
  • 最近正上映的影片有哪些?
  • 用户问题
  • └ city_name
  • String
  • 可选
  • 北京市
  • 城市名
  • └ page_index
  • Number
  • 可选
  • 0
  • 从0开始
  • └ rewrite_human_message
  • String
  • 可选
  • 最近正上映的影片有哪些?
  • 改写后的用户问题
  • └ tenant_code
  • String
  • 必须
  • 租户信息
  • 租户信息

响应参数

名称 类型 示例值 描述
return_value Data 返回值
  • cards
  • Card []
  • 卡片信息
  • └ card_type
  • Number
  • 1
  • 卡片类型
  • items
  • Item []
  • 商品详情
  • └ title
  • String
  • 电影名/演出名
  • 商品名
  • └ description
  • String
  • 描述
  • 商品描述
  • └ score
  • String
  • 8.0
  • 评分
  • └ want_count
  • Number
  • 300
  • 想看数
  • └ item_status
  • String
  • NORMAL
  • 电影:NORMAL(购票),PRE(预售),VOD(看正片)
  • └ open_day
  • Date
  • 2024-10-08 10:00:00
  • 开映时间
  • └ open_time
  • String
  • 2024-10-08 10:00
  • 开映时间
  • └ director
  • String
  • 张艺谋
  • 导演
  • └ leading_role
  • String
  • 刘德华
  • 主演
  • └ cover
  • String
  • http:://xxxxx
  • 封面
  • └ cover_type
  • Number
  • 1
  • 1:图片 2:视频
  • └ category_name
  • String
  • 科幻
  • 分类名
  • └ jump_url
  • String
  • http://xxxx
  • 跳转链接
  • └ item_type
  • Number
  • 1
  • 1:电影 2:演出
  • └ country
  • String
  • 中国大陆
  • 国家(电影专用)
  • └ show_version
  • String
  • 2D
  • 电影版本(电影专用)
  • └ duration
  • Number
  • 100
  • 影片时长
  • └ id
  • String
  • id
  • 对象id
  • └ ai_answer
  • String
  • 最近的热门电影是:xxxx
  • AI回答
return_message String 成功 接口返回信息
return_code String 0 接口码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmOpenAiRecommendQueryRequest req = new FilmOpenAiRecommendQueryRequest();
FilmOpenAiRecommendQueryRequest.GuideAiQueryParam obj1 = new FilmOpenAiRecommendQueryRequest.GuideAiQueryParam();
obj1.setUserInfo("{}");
obj1.setCityCode(110100L);
obj1.setUtdid("utdid");
obj1.setPageSize(10L);
obj1.setIntent("GET_SHOW_LIST");
obj1.setIntentParams("{}");
obj1.setScene("show");
obj1.setOuterSessionId("xxx");
obj1.setHumanMessage("最近正上映的影片有哪些?");
obj1.setCityName("北京市");
obj1.setPageIndex(0L);
obj1.setRewriteHumanMessage("最近正上映的影片有哪些?");
obj1.setTenantCode("租户信息");
req.setGuideAiQueryParam(obj1);
FilmOpenAiRecommendQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_open_ai_recommend_query_response>
    <return_value>
        <cards>
            <card>
                <card_type>1</card_type>
                <items>
                    <item>
                        <title>电影名/演出名</title>
                        <description>描述</description>
                        <score>8.0</score>
                        <want_count>300</want_count>
                        <item_status>NORMAL</item_status>
                        <open_day>2024-10-08 10:00:00</open_day>
                        <open_time>2024-10-08 10:00</open_time>
                        <director>张艺谋</director>
                        <leading_role>刘德华</leading_role>
                        <cover>http:://xxxxx</cover>
                        <cover_type>1</cover_type>
                        <category_name>科幻</category_name>
                        <jump_url>http://xxxx</jump_url>
                        <item_type>1</item_type>
                        <country>中国大陆</country>
                        <show_version>2D</show_version>
                        <duration>100</duration>
                        <id>id</id>
                    </item>
                </items>
            </card>
        </cards>
        <ai_answer>最近的热门电影是:xxxx</ai_answer>
    </return_value>
    <return_message>成功</return_message>
    <return_code>0</return_code>
</film_open_ai_recommend_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

返回
顶部