万邦阿里巴巴中国站获得1688商品评论 API 返回值说明

158 阅读4分钟

item_review-获得1688商品评论 注册开通

onebound.1688.item_review

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:num_iid=612398037607&user_id=3838217801&nick=浙江祥珑科技

参数说明:num_iid:1688商品ID
user_id卖家id
nick卖家昵称

响应参数

Version: Date:

名称类型必须示例值描述
itemsitems[]0商品评论数据

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=612398037607&user_id=3838217801&nick=浙江祥珑科技"

响应示例

{
	"items": {
		"num_iid": "612398037607",
		"total_results": "10+",
		"rate_average": "5.0",
		"good_percent": "好评率100%",
		"detail_url": "https://rate2.m.1688.com/page/rateListForOffer.html?offerId=612398037607&sellerLoginId=浙江祥珑科技&offerScene=dsc",
		"item": [
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-08-29 19:06:39",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:可爱喵+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-08-02 10:43:27",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌小黄+定时线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-07-21 21:30:12",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:饭团+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-07-07 00:04:41",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "2.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌小黄+3米延长线|颜色:萌大白+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-06-19 10:36:17",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌大白",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-06-19 10:36:03",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌大白+定时线",
				"starLevel": "5",
				"unit": "个"
			}
		],
		"data_from": "1688app"
	},
	"secache": "4eafb7d1ba85181a0f9fa8e658351f5c",
	"secache_time": 1649993685,
	"secache_date": "2022-04-15 11:34:45",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:9 max:11000",
	"execution_time": "3.592",
	"server_time": "Beijing/2022-04-15 11:34:45",
	"client_ip": "106.6.33.38",
	"call_args": {
		"num_iid": "612398037607",
		"data": "3838217801",
		"page": "浙江祥珑科技"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "0.76MB",
	"request_id": "gw-4.6258e7d1b5595",
	"last_id": "885798952"}

异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "1688",
  "request_id": "1ee0ffc041242"}

相关资料错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误