万邦淘宝/天猫获取淘宝直播分类id接口 API 返回值说明

113 阅读3分钟

item_videolist_cat-获取淘宝直播分类id接口 [查看演示API测试工具 注册开通

onebound.taobao.item_videolist_cat

公共参数

请求地址: api-gw.onebound.cn/taobao/item…

名称类型必须描述
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版本

请求参数

请求参数:q=

参数说明:q:视频分类\

响应参数

Version: Date:

名称类型必须示例值描述
titleString0衣服面料很好 穿起来很舒服 衣服挺合适的!标题
channelIdString013分类ID

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_videolist_cat/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q="

响应示例

{"q": "",
	"page_size": 18,
	"real_total_results": 18,
	"total_results": 18,
	"pagecount": 1,
	"data_from": "app",
	"item": [
		{
			"title": "吃货力荐",
			"channelId": "13"
		},
		{
			"title": "亲子萌娃",
			"channelId": "9"
		},
		{
			"title": "花鸟市场",
			"channelId": "60"
		},
		{
			"title": "时髦穿搭",
			"channelId": "7"
		},
		{
			"title": "珠光宝气",
			"channelId": "29"
		},
		{
			"title": "居家生活",
			"channelId": "69"
		},
		{
			"title": "家乡好货",
			"channelId": "65"
		},
		{
			"title": "全球扫货",
			"channelId": "12"
		},
		{
			"title": "男神潮范",
			"channelId": "14"
		},
		{
			"title": "潮电数码",
			"channelId": "81"
		},
		{
			"title": "汽车嗨购",
			"channelId": "97"
		},
		{
			"title": "一起变美",
			"channelId": "8"
		},
		{
			"title": "产地直供",
			"channelId": "49"
		},
		{
			"title": "大牌精选",
			"channelId": "61"
		},
		{
			"title": "乐活时光",
			"channelId": "11"
		},
		{
			"title": "医美医疗",
			"channelId": "88"
		},
		{
			"title": "吃喝玩乐",
			"channelId": "72"
		},
		{
			"title": "旅行优选",
			"channelId": "31"
		}
	],
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:8 max:10000",
	"execution_time": 1.338,
	"server_time": "Beijing/2021-01-20 13:58:12",
	"client_ip": "115.151.186.91",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "5.34MB",
	"request_id": "gw-4.6007c67325f90"
	 }
```
```
异常示例

```
{
  "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": "taobao",
  "request_id": "15ee0ffc041242"}
```

[]()相关资料错误码解释

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