一、参数

公共参数

请求地址: https://api-gw.onebound.cn/taobao/seller_info

名称

类型

必须

描述

key

String

是

调用key（必须以GET方式拼接在URL中）

secret

String

是

调用密钥

api_name

String

是

API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]

cache

String

否

[yes,no]默认yes，将调用缓存的数据，速度比较快

result_type

String

否

[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读

lang

String

否

[cn,en,ru]翻译语言，默认cn简体中文

version

String

否

API版本


请求参数

请求参数：nick=lin130021&shop_url=https://shop63387065.taobao.com/

参数说明：nick:掌柜昵称
shop_url:PC端店铺主页地址


响应参数

名称

类型

必须

示例值

描述

shop_id

Bigint

0

63387065

店铺ID

sid

Bigint

0

63387065

seller_id

Bigint

0

59531614

卖家ID

nick

String

0

lin130021

掌柜名字

shop_name

String

0

外新人 琳琳

店铺名

shop_type

String

0

c

店铺类型

shop_url

String

0

https://shop63387065.taobao.com/

店铺主页

level

Mix

0

{"rank": 5,"type":"cap"}

店铺等级

score

Mix

0

[]

店铺评分

tel

String

0

1891226351

电话

data_from

String

0

二、示例


请求示例

  • Curl
  • PHP
  • PHPsdk
  • JAVA
  • C#
  • Python
<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&nick=lin130021&shop_url=https://shop63387065.taobao.com/";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

  前往获取key和secret


响应示例

异常示例


三、错误码解释

状态代码(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

未知错误

否