查号API接口,微查宝

接口说明

错误码

示例代码

JSON返回示例

接口地址: https://api.weichabao.com/json/open/query

请求方式: GET/POST

返回格式: JSON

接口密钥: 登录后查看

请求参数

参数名	类型	必填	示例	描述
wwid	string	是	tb12391898102123	淘宝旺旺账号
app_id	Number	是	143176868	微查宝应用id
sign	Number	是	626da9cbf0938332c6d94da89dd053de	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。签名算法见《示例代码》。
timestamp	String	是	1394276508	客户端时间。时间戳，格式如：1394276508
no_credit	Boolean	否	1	不获取旺旺信誉数据。0=否，1=是，默认否

返回参数说明

参数名	类型	示例	描述
msg	String	请求成功	返回码说明
status_code	Number	200	系统返回码
data	Array	详情，请查看data参数说明	旺旺详细数据

请求成功，data参数说明

参数名	类型	示例	描述
code	String	200	应用返回码
desc	Number	请求成功	返回码说明
wwid	String	tb12391898102123	淘宝账号(旺旺名称)
buyer_good_rate	String	100%	买家好评率
buyer_icon	String	3黄钻	买家等级
reg_time	String	2013-02-22 09:34:42	注册时间
week_avg	String	2.51	周平均
month_avg	String	2.51	月平均
sex	String	女	性别
shop	String	非店号	是否为卖家（非店号\|C店\|天猫）
amoy_age	String	2797天	淘龄
original_authed	String	已实名认证	实名认证（已实名认证｜未实名认证）
vip_level	String	10	是否为超级会员(0=普通会员，10=超级会员)
vip	String	淘宝V3会员	淘宝号的会员等级
pd_num	int	0	跑单
qz_num	int	0	敲诈
pz_num	int	0	骗子
dj_num	int	0	打假
cp_num	int	0	差评
tk_num	int	0	淘客
jq_num	int	5	降权
wg_num	int	0	违规
cj_num	int	0	抽检

系统级错误码（字段：status_code）

错误码	说明	解决方案
9003	参数不正确	检测自己的参数与文档入参说明是否相符
9004	app_id不存在	请输入正确的接口应用app_id参数
9005	签名错误	检测签名生成方式是否与示例一致
9006	点数不足	登录进行充值
9007	系统繁忙	重新请求

应用级错误码（字段：code）

错误码	说明	解决方案
1001	旺旺号不存在	检测旺旺号是否真实存在
1002	信誉查询异常,请重试	重新请求接口（本次请求不扣费）

sign签名算法

/** 以php为例 sgin签名生成 */

/* 生成签名方法 */
function generateSign(array $params, $appSecret)
{
    // 过滤数组空值
    $params = array_filter($params);

    // 根据数组键升序排序
    ksort($params);

    // 追私钥到参数尾部
    $params['key'] = $appSecret;

    $str = http_build_query($params);
    return strtolower(md5($str));
}

// 应用ID
$appId = 1431176868;
// 私钥
$appSecret = 'a7598cbkdoe5d902a397cbfb6p92c630c872f0fa';

// 请求参数
$params = [
    'wwid' => 'tb12391898102123',
    'app_id' => $appId,
    'timestamp' => time(),
    // 'no_credit' => 1,
];

generateSign($params, $appSecret); // 输出：c805e8c0f108be57ea65253ff3517337

调用示例

/** 以php为例 */

// 应用ID
$appId = 1431176868;
// 私钥
$appSecret = 'a7598cbkdoe5d902a397cbfb6p92c630c872f0fa';

// 请求参数
$params = [
    'wwid' => 'tb12391898102123',
    'app_id' => $appId,
    'timestamp' => time(),
    // 'no_credit' => 1,
];

$params[sign] = generateSign($params, $appSecret);

// 初始化一个 cURL 对象
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
// 运行cURL，请求接口
$data = curl_exec($curl);
// 关闭URL请求
curl_close($curl);
$data = json_decode($data, true);
var_dump($data);

请求成功

{
    "msg": "请求成功",
    "status_code": 200,
    "data": {
        "code": 0,
        "desc": "ok",
        "credit_data": {
            "wwid": "tb12391898102123",
            "buyer_good_rate": "100%",
            "buyer_icon": "3黄钻",
            "reg_time": "2013-02-22 09:34:42",
            "week_avg": "2.51",
            "month_avg": "10.76",
            "sex": "女",
            "shop": "非店号",
            "amoy_age": "2797天",
            "original_authed": "已实名认证",
            "vip_level": "10",
            "vip": "淘宝V3会员"
        },
        "blacklist_data": {
            "pd_num": 0,
            "qz_num": 0,
            "pz_num": 0,
            "dj_num": 0,
            "cp_num": 0,
            "tk_num": 0,
            "jq_num": 5,
            "wg_num": 0,
            "cj_num": 0
        }
    }
}

请求成功（不查询信誉信息，只查黑号降权号[no_credit=1]）

{
    "msg": "请求成功",
    "status_code": 200,
    "data": {
        "code": 0,
        "desc": "ok",
        "credit_data": [],
        "blacklist_data": {
            "pd_num": 0,
            "qz_num": 0,
            "pz_num": 0,
            "dj_num": 0,
            "cp_num": 0,
            "tk_num": 0,
            "jq_num": 0,
            "wg_num": 0,
            "cj_num": 0
        }
    }
}

应用异常提示

{
    "msg": "请求成功",
    "status_code": 200,
    "data": {
        "code": 1001,
        "desc": "旺旺号不存在"
    }
}

系统异常提示

{
    "status_code": 9004,
    "msg": "app_id不存在"
}