万邦阿里巴巴中国站获取1688同行还在看 API 返回值说明

万邦Noah
89 阅读4分钟

item_search_peerbuy-获取1688同行还在看 注册开通

onebound.1688.item_search_peerbuy

公共参数

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[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简体中文
versionString否API版本

请求参数

请求参数：num_iid=675442807002&sid=b2b-22065146396259334d

参数说明：num_iid：商品ID
sid:1688店铺标识id(详情接口可获取)

响应参数

Version: Date:

名称类型必须示例值描述
itemsitem[]0同行还在看

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_search_peerbuy/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=675442807002&sid=b2b-22065146396259334d"

响应示例

{
	"item": [
		{
			"num_iid": "602655483658",
			"price": "10.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/499/176/8637671994_408979008.jpg",
			"title": "U盘4g 8g 16g32G 金属u盘虎扣u盘 钥匙扣 u盘 防水优盘车载优盘",
			"sales": "12559",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602655483658.html"
		},
		{
			"num_iid": "602011556785",
			"price": "14.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/087/397/8627793780_408979008.jpg",
			"title": "厂家直销创意优盘4G/8G/16G金属防水礼品商务可定制LOGO钥匙u盘",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602011556785.html"
		},
		{
			"num_iid": "602463762086",
			"price": "14.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/504/631/8638136405_408979008.jpg",
			"title": "USB2.0高速钥匙扣皮套U盘16G 皮质优盘 商务企业礼品定制logo刻字",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602463762086.html"
		},
		{
			"num_iid": "602011556738",
			"price": "10.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/153/968/8786869351_408979008.jpg",
			"title": "U盘厂家批发金属礼品优盘8G16g32g迷你个性 定制企业LOGO车载优盘",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602011556738.html"
		},
		{
			"num_iid": "602255237571",
			"price": "15.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/958/348/8647843859_408979008.jpg",
			"title": "钢边皮套u盘8G 商务礼品创意个性u盘 皮质U盘 定制logo刻字",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602255237571.html"
		},
		{
			"num_iid": "602656607117",
			"price": "35.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/335/054/8602450533_408979008.jpg",
			"title": "手机U盘32G64G128G 手机u盘 手机安卓电脑三用三通 定制LOGO",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602656607117.html"
		},
		{
			"num_iid": "602463190323",
			"price": "15.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/829/511/8638115928_408979008.jpg",
			"title": "直销新款翻盖皮套U盘 定制企业LOGO皮革优盘定制 礼品u盘16GB",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602463190323.html"
		},
		{
			"num_iid": "602462310730",
			"price": "15.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/141/674/8642476141_408979008.jpg",
			"title": "厂家直销 创意手机U盘8G/16G/32G OTG双插头个性优盘 可定制LOGO",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602462310730.html"
		},
		{
			"num_iid": "602012472340",
			"price": "18.0",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/690/584/8642485096_408979008.jpg",
			"title": "批发定制u盘水晶U盘8G 高端办公礼品 钻石礼品U盘 施洛华水晶U盘",
			"sales": "0",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/602012472340.html"
		},
		{
			"num_iid": "678315962743",
			"price": "11.5",
			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01hc00Km2KyItkPj81k_!!2206514639625-0-cib.jpg",
			"title": "usb",
			"sales": "120",
			"seller_id": "2206514639625",
			"detail_url": "https://detail.1688.com/offer/678315962743.html"
		}
	],
	"_ddf": "1688app",
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:2 max:5000 all[2=2+0+0];expires:2023-04-25",
	"execution_time": "0.426",
	"server_time": "Beijing/2022-07-22 15:15:32",
	"client_ip": "106.6.33.140",
	"call_args": [],
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "3.88MB",
	"request_id": "gw-1.62da4e945a302",
	"last_id": "1094078190"
}

异常示例

{
  "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": "4ee0ffc041242"
}

相关资料错误码解释

状态代码(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未知错误否
avatar
文章
阅读
粉丝