淘宝开放平台

登录
文档中心 > API类目 > 酒店商品API

酒店商品API

taobao.xhotel.comment.getmixratelist (通用评价接口)

通用的评价接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_get_mix_rate_list_param TopGetMixRateListParam 可选 1
  • └ biz_type
  • Number
  • 可选
  • 1
  • 业务类型
  • └ item_id
  • Number
  • 可选
  • 1
  • 商品id
  • └ load_reply
  • Number
  • 可选
  • 1
  • 加载点评
  • └ page_no
  • Number
  • 可选
  • 1
  • 页码
  • └ page_size
  • Number
  • 可选
  • 1
  • 分页大小
  • └ sort
  • Number
  • 可选
  • 1
  • 排序
  • └ tab_filter
  • String
  • 可选
  • 1
  • tab过滤

响应参数

名称 类型 示例值 描述
result Result 1 接口返回model
  • └ http_status_code
  • Number
  • 1
  • 状态码
  • model
  • GetMixRateListResult
  • 134523^4351232
  • 模型
  • └ config_info
  • String
  • 1
  • 页面布局信息
  • └ err_code
  • String
  • 1
  • 错误代码
  • └ err_msg
  • String
  • 1
  • 错误详细描述
  • └ has_next_page
  • Number
  • 1
  • 是否可以向下翻页，0不可以，1可以
  • item_statistic
  • ItemStatisticVo
  • 1
  • 统计信息
  • └ best_item
  • String
  • 11
  • 最佳得分项
  • └ is_five_grade
  • Number
  • 1
  • 五分制标记, 1为五分制， 0为十分制
  • └ rate_cnt
  • Number
  • 1
  • 评论总数
  • └ rate_pic_cnt
  • Number
  • 1
  • 有图的评论总数
  • └ recommend_str
  • String
  • 1
  • 推荐率
  • └ reply_cnt
  • Number
  • 1
  • 回复总数
  • room_tab_infos
  • TabInfo []
  • 1
  • tab信息
  • └ attitude
  • Number
  • 1
  • 标签的态度 1好 0中性 -1 差
  • └ is_click
  • Boolean
  • 1
  • tab是否点击
  • └ tab_code
  • String
  • 1
  • tab编码
  • └ tab_detail
  • String
  • 1
  • tab下的统计数据
  • └ tab_id
  • Number
  • 1
  • id
  • └ tab_name
  • String
  • 1
  • 名称
  • └ type
  • Number
  • 1
  • 标签的类型 0正常 1热词 2房型 3度假
  • └ score_desc
  • String
  • 1
  • 评分描述： 非常好
  • └ score_detail
  • String
  • 1
  • 评分详情，json格式
  • score_infos
  • ScoreInfo []
  • 1
  • 不同分数的数量
  • └ count
  • Number
  • 1
  • 数量
  • └ desc
  • String
  • 1
  • 描述
  • └ label
  • String
  • 1
  • 标签
  • └ score
  • String
  • 1
  • 分数
  • └ score_level
  • Number
  • 1
  • 评分星级
  • └ source
  • Number
  • 1
  • source来源 0自采 1共享 21agoda 22艺龙 23tripAdvisor
  • sub_item_infos
  • TabInfo []
  • 1
  • tab信息
  • └ attitude
  • Number
  • 1
  • 态度
  • └ is_click
  • Boolean
  • 1
  • 是否点击
  • └ tab_code
  • String
  • 1
  • 编码
  • └ tab_detail
  • String
  • 1
  • 详情
  • └ tab_id
  • Number
  • 1
  • id
  • └ tab_name
  • String
  • 1
  • 名称
  • └ type
  • Number
  • 1
  • 类型
  • tab_info_s
  • TabInfo []
  • 1
  • tab信息
  • └ attitude
  • Number
  • 1
  • 态度
  • └ is_click
  • Boolean
  • 1
  • 点击
  • └ tab_code
  • String
  • 1
  • 编码
  • └ tab_detail
  • String
  • 1
  • 详情
  • └ tab_id
  • Number
  • 1
  • id
  • └ tab_name
  • String
  • 1
  • 名称
  • └ type
  • Number
  • 1
  • 类型
  • └ tab_show_lines
  • Number
  • 1
  • 热词显示的行数
  • └ total_score
  • String
  • 1
  • 总评分
  • └ travel_item_id
  • Number
  • 1
  • 酒店类目是标准酒店ID
  • └ travel_item_info
  • String
  • 1
  • 旅游商品信息
  • └ trip_advate_cnt
  • Number
  • 1
  • tripAdv评论数
  • mix_rates
  • MixRateVo []
  • 1
  • 商品评论列表
  • └ agree_count
  • Number
  • 1
  • 顶数量
  • └ biz_type
  • Number
  • 1
  • 业务类型
  • └ content
  • String
  • 11
  • 内容
  • └ default_icon
  • Number
  • 1
  • 默认icon
  • └ disagree_count
  • Number
  • 1
  • 差评数
  • └ gmt_create
  • String
  • 1
  • 创建时间
  • └ id
  • Number
  • 1
  • id
  • └ item_id
  • Number
  • 1
  • 商品id
  • └ item_info
  • String
  • 1
  • 商品信息
  • └ item_rate_id
  • Number
  • 1
  • 商品评论ID
  • item_replies
  • ItemRateReplyVo []
  • 1
  • 所有商品评论回复
  • └ biz_type
  • Number
  • 1
  • 业务类型
  • └ content
  • String
  • 1
  • 内容
  • └ gmt_create
  • String
  • 1
  • 创建日期
  • └ interval_day
  • Number
  • 11
  • 与主评间隔天数
  • └ media_info
  • String
  • 1
  • 图片信息
  • └ owner
  • Number
  • 1
  • 当前用户的评价 0:不是, 1:是
  • └ parent_id
  • Number
  • 1
  • 回复的是那一条，如果是回复主评为0，否则为追评id，组成树形结构
  • parent_info
  • ParentInfo
  • 1
  • 被回复人的冗余信息
  • └ user_nick
  • String
  • 1
  • 用户昵称,已脱敏
  • └ reply_id
  • Number
  • 1
  • 该条回复的id
  • └ reply_type
  • Number
  • 11
  • 回复类型 0买家追评 1卖家回复
  • └ status
  • Number
  • 1
  • 状态
  • └ travel_item_id
  • Number
  • 1
  • 酒店类目是标准酒店ID ，用来分库
  • └ user_nick
  • String
  • 11
  • 用户名称,已脱敏
  • like
  • LikeTargetCount
  • 1
  • 点赞数据
  • └ count
  • Number
  • 1
  • 目标对象的赞数量或者踩数量
  • └ target_id
  • Number
  • 1
  • 目标对象的ID
  • └ voted
  • Boolean
  • 1
  • 针对当前targetId,是否点赞过或踩过
  • └ media_info
  • String
  • 1
  • 图片信息,图片URL的list
  • └ order_id
  • Number
  • 1
  • 订单ID
  • └ order_id_str
  • String
  • 1
  • 订单ID
  • └ order_info
  • String
  • 1
  • 交易信息
  • └ owner
  • Number
  • 1
  • 当前用户的评价 0:不是, 1:是
  • └ picture_urls
  • String []
  • 11
  • 图片URL
  • └ poi_str
  • String
  • 1
  • POI固定文本
  • └ redirect_url
  • String
  • 1
  • 跳转URL
  • └ reply_count
  • Number
  • 1
  • 回复数量
  • └ score_detail
  • String
  • 1
  • 评分详情
  • └ seller_score_detail
  • String
  • 1
  • 评分详情
  • └ sku
  • String
  • 1
  • SKU
  • └ source
  • Number
  • 1
  • 点评来源
  • └ source_type_name
  • String
  • 1
  • 点评来源名称
  • └ split_line_content
  • String
  • 1
  • 分割线内容
  • └ status
  • Number
  • 1
  • 置顶状态 0 普通，1置顶
  • tab_infos
  • TabInfo []
  • 1
  • 1
  • └ attitude
  • Number
  • 1
  • 态度
  • └ is_click
  • Boolean
  • 1
  • 是否点击
  • └ tab_code
  • String
  • 1
  • 编码
  • └ tab_detail
  • String
  • 1
  • 详情
  • └ tab_id
  • Number
  • 1
  • id
  • └ tab_name
  • String
  • 1
  • 名称
  • └ type
  • Number
  • 1
  • 类型
  • └ tag_info
  • String
  • 1
  • 标签信息
  • └ title
  • String
  • 1
  • 评论title,留作备用
  • └ top_status
  • Number
  • 1
  • 置顶状态 0 普通，1置顶
  • └ top_status_icon
  • String
  • 1
  • 置顶图标
  • └ total_score
  • Number
  • 1
  • 置顶图标
  • └ travel_name
  • String
  • 1
  • 总评分
  • └ travel_sub_item_id
  • Number
  • 1
  • 航旅标准商品子类型id
  • └ travel_sub_item_info
  • String
  • 1
  • 航旅标准商品子类型信息
  • └ trip_guid_id
  • Number
  • 1
  • 行程ID
  • └ ttid
  • String
  • 1
  • 冗余
  • └ user_nick
  • String
  • 1
  • 用户昵称,已脱敏
  • rate_entrance
  • AddRateEntrance
  • 1
  • 写点评页跳转信息
  • └ available
  • Number
  • 1
  • 是否可以发表评价,0:不可以发表评价,1:可以发表评价.
  • jump_info
  • JumpInfo
  • 1
  • 写点评的跳转链接
  • └ jump_h5_url
  • String
  • 1
  • h5地址
  • └ jump_native
  • Boolean
  • 1
  • 是否跳转native
  • └ jump_native_url
  • String
  • 1
  • native地址
  • └ native_version
  • String
  • 11
  • 要往native跳转的客户端版本,当该字段存在时，只有大于该版本才会走native跳转
  • └ page_name
  • String
  • 1
  • native页面信息
  • └ name
  • String
  • 1
  • 名称
  • └ show_status
  • Number
  • 1
  • 是否展示入口 0:不展示,1:展示
  • └ success
  • Boolean
  • 1
  • 成功
  • └ total_num
  • Number
  • 1
  • 总数
  • └ msg_code
  • String
  • 1
  • msgCode
  • └ msg_info
  • String
  • 1
  • msgInfo
  • └ success
  • Boolean
  • false
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelCommentGetmixratelistRequest req = new XhotelCommentGetmixratelistRequest();
XhotelCommentGetmixratelistRequest.TopGetMixRateListParam obj1 = new XhotelCommentGetmixratelistRequest.TopGetMixRateListParam();
obj1.setBizType(1L);
obj1.setItemId(1L);
obj1.setLoadReply(1L);
obj1.setPageNo(1L);
obj1.setPageSize(1L);
obj1.setSort(1L);
obj1.setTabFilter("1");
req.setParamGetMixRateListParam(obj1);
XhotelCommentGetmixratelistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
<xhotel_comment_getmixratelist_response>
    <result>
        <http_status_code>1</http_status_code>
        <model>
            <config_info>1</config_info>
            <err_code>1</err_code>
            <err_msg>1</err_msg>
            <has_next_page>1</has_next_page>
            <item_statistic>
                <best_item>11</best_item>
                <is_five_grade>1</is_five_grade>
                <rate_cnt>1</rate_cnt>
                <rate_pic_cnt>1</rate_pic_cnt>
                <recommend_str>1</recommend_str>
                <reply_cnt>1</reply_cnt>
                <room_tab_infos>
                    <tab_info>
                        <attitude>1</attitude>
                        <is_click>1</is_click>
                        <tab_code>1</tab_code>
                        <tab_detail>1</tab_detail>
                        <tab_id>1</tab_id>
                        <tab_name>1</tab_name>
                        <type>1</type>
                    </tab_info>
                </room_tab_infos>
                <score_desc>1</score_desc>
                <score_detail>1</score_detail>
                <score_infos>
                    <score_info>
                        <count>1</count>
                        <desc>1</desc>
                        <label>1</label>
                        <score>1</score>
                    </score_info>
                </score_infos>
                <score_level>1</score_level>
                <source>1</source>
                <sub_item_infos>
                    <tab_info>
                        <attitude>1</attitude>
                        <is_click>1</is_click>
                        <tab_code>1</tab_code>
                        <tab_detail>1</tab_detail>
                        <tab_id>1</tab_id>
                        <tab_name>1</tab_name>
                        <type>1</type>
                    </tab_info>
                </sub_item_infos>
                <tab_info_s>
                    <tab_info>
                        <attitude>1</attitude>
                        <is_click>1</is_click>
                        <tab_code>1</tab_code>
                        <tab_detail>1</tab_detail>
                        <tab_id>1</tab_id>
                        <tab_name>1</tab_name>
                        <type>1</type>
                    </tab_info>
                </tab_info_s>
                <tab_show_lines>1</tab_show_lines>
                <total_score>1</total_score>
                <travel_item_id>1</travel_item_id>
                <travel_item_info>1</travel_item_info>
                <trip_advate_cnt>1</trip_advate_cnt>
            </item_statistic>
            <mix_rates>
                <mix_rate_vo>
                    <agree_count>1</agree_count>
                    <biz_type>1</biz_type>
                    <content>11</content>
                    <default_icon>1</default_icon>
                    <disagree_count>1</disagree_count>
                    <gmt_create>1</gmt_create>
                    <id>1</id>
                    <item_id>1</item_id>
                    <item_info>1</item_info>
                    <item_rate_id>1</item_rate_id>
                    <item_replies>
                        <item_rate_reply_vo>
                            <biz_type>1</biz_type>
                            <content>1</content>
                            <gmt_create>1</gmt_create>
                            <interval_day>11</interval_day>
                            <media_info>1</media_info>
                            <owner>1</owner>
                            <parent_id>1</parent_id>
                            <parent_info>
                                <user_nick>1</user_nick>
                            </parent_info>
                            <reply_id>1</reply_id>
                            <reply_type>11</reply_type>
                            <status>1</status>
                            <travel_item_id>1</travel_item_id>
                            <user_nick>11</user_nick>
                        </item_rate_reply_vo>
                    </item_replies>
                    <like>
                        <count>1</count>
                        <target_id>1</target_id>
                        <voted>1</voted>
                    </like>
                    <media_info>1</media_info>
                    <order_id>1</order_id>
                    <order_id_str>1</order_id_str>
                    <order_info>1</order_info>
                    <owner>1</owner>
                    <picture_urls>
                        <string>11</string>
                    </picture_urls>
                    <poi_str>1</poi_str>
                    <redirect_url>1</redirect_url>
                    <reply_count>1</reply_count>
                    <score_detail>1</score_detail>
                    <seller_score_detail>1</seller_score_detail>
                    <sku>1</sku>
                    <source>1</source>
                    <source_type_name>1</source_type_name>
                    <split_line_content>1</split_line_content>
                    <status>1</status>
                    <tab_infos>
                        <tab_info>
                            <attitude>1</attitude>
                            <is_click>1</is_click>
                            <tab_code>1</tab_code>
                            <tab_detail>1</tab_detail>
                            <tab_id>1</tab_id>
                            <tab_name>1</tab_name>
                            <type>1</type>
                        </tab_info>
                    </tab_infos>
                    <tag_info>1</tag_info>
                    <title>1</title>
                    <top_status>1</top_status>
                    <top_status_icon>1</top_status_icon>
                    <total_score>1</total_score>
                    <travel_name>1</travel_name>
                    <travel_sub_item_id>1</travel_sub_item_id>
                    <travel_sub_item_info>1</travel_sub_item_info>
                    <trip_guid_id>1</trip_guid_id>
                    <ttid>1</ttid>
                    <user_nick>1</user_nick>
                </mix_rate_vo>
            </mix_rates>
            <rate_entrance>
                <available>1</available>
                <jump_info>
                    <jump_h5_url>1</jump_h5_url>
                    <jump_native>1</jump_native>
                    <jump_native_url>1</jump_native_url>
                    <native_version>11</native_version>
                    <page_name>1</page_name>
                </jump_info>
                <name>1</name>
                <show_status>1</show_status>
            </rate_entrance>
            <success>1</success>
            <total_num>1</total_num>
        </model>
        <msg_code>1</msg_code>
        <msg_info>1</msg_info>
        <success>false</success>
    </result>
</xhotel_comment_getmixratelist_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部