detectrisk

接口说明

检测用户是否是作弊用户。

请求地址

POST https://openapi.baidu.com/rest/2.0/smartapp/detectrisk?access_token=ACCESS_TOKEN

方法参数

query 参数

post 参数

返回值说明

data 字段描述

返回值示例

{
    "data": {
        "level": "3",
        "tag": [
            "空"
        ]
    },
    "errmsg": "succ",
    "errno": 0,
    "request_id": "3922098303",
    "timestamp": 1561110003
}

返回值示例

检测作弊用户参考代码

• PHP
• GOLANG

<?php
/**
 * @desc php curl方式检测用户是否是作弊用户
 */
// 参考 accessToken 获取文档；
$accessToken = "xxx";
// 小程序 appKey,从 B 端平台获取；
$appKey = "xxxx"; 
// 获取方式参考文档中 "post 参数" 解释
$xtokenArr = array( 
    "key" => "XXX", 
    "value" => "XXX"
);
// 用户 ip
$clientIp = "xxx.xxx.xxx.xxx";
// 11位明文手机号
$phone = "130xxxxxxxx";
// 从请求 header 中获取
$useragent = "xxxxxxx";
// ev 1 为点击按钮获取，请按照文档设置合理的数值
$ev = "1"; 
$ret = dectectRisk($accessToken, $appKey, $xtokenArr, $clientIp, $phone, $useragent, $ev);
var_dump($ret);
/**
 * @desc 发起检测用户是否是作弊用户请求
 */
function dectectRisk($accessToken, $appKey, $xtokenArr, $clientIp, $phone, $useragent, $ev){
    $url = "https://openapi.baidu.com/rest/2.0/smartapp/detectrisk?access_token={$accessToken}";
    $encryptedPhone = sha1($phone);
    $postDataArr = array(
        'appkey' => $appKey,
        'xtoken' => json_encode($xtokenArr),
        // 风控类型 目前只有 marketing
        'type' => "marketing", 
        'clientip' => $clientIp,
        'ts' => time(),
        'ev' => $ev,
        'useragent' => $useragent,
        'phone' => $encryptedPhone, 
    );
    $resp = curlPost($url, $postDataArr);
    return $resp;
}
/**
 * @desc curl POST请求,可以按照自己实际编程环境替换
 * @param string $url 请求的url地址
 * @param array $postDataArr 传递的数组参数
 * @return string 检测结果json字符串
 */
function curlPost($url, $postDataArr){
    $headerArr =array("Content-type:application/x-www-form-urlencoded");
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postDataArr);
    curl_setopt($curl,CURLOPT_HTTPHEADER,$headerArr);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $output = curl_exec($curl);
    curl_close($curl);
    return $output;
}

// Go http PostForm 方式检测用户是否是作弊用户
package main
import (
    "crypto/sha1"
    "fmt"
    "net/url"
    "strconv"
    "strings"
    "time"
    "encoding/json"
    "io/ioutil"
    "log"
    "net/http"
)
// 返回的信息
type detectriskResp struct {
    Errno     int    `json:"errno"`
    Errmsg    string `json:"errmsg"`
    RequestId string `json:"request_id"`
    Timestamp int64  `json:"timestamp"`
    Data      struct {
        Level string   `json:"level"`
        Tag   []string `json:"tag"`
    } `json:"data"`
}
func main() {
    // 获取方式参考文档中 "post 参数" 解释
    xtokenMap := map[string]string{
        "key":   "XXX",
        "value": "XXX",
    }
    xtokenByte, err := json.Marshal(xtokenMap)
    if err != nil {
        log.Fatalln(err)
        return
    }
    // 参考 accessToken 获取文档；
    accessToken := "xxx"  
    // 小程序 appKey,从 B 端平台获取；        
    appKey := "xxxx"     
    // 用户 ip         
    clientIp := "xxx.xxx.xxx.xxx"
    // 11位明文手机号 
    phone := "130xxxxxxxx" 
    // 11位明文手机号       
    useragent := "xxxxxxx" 
    // ev 1 为点击按钮获取，请按照文档设置合理的数值       
    ev := "1"                     
    xtoken := string(xtokenByte)
    resp, err := dectectRisk(accessToken, appKey, xtoken, clientIp, ev, useragent, phone)
    fmt.Println(resp, err)
}
// dectectRisk 发起检测用户是否是作弊用户请求
func dectectRisk(accessToken, appKey, xtoken, clientIp, ev, useragent, phone string) (*detectriskResp, error) {
    urlPath := "https://openapi.baidu.com/rest/2.0/smartapp/detectrisk?access_token=" + accessToken
    h := sha1.New()
    h.Write([]byte(phone))
    phoneSha1 := fmt.Sprintf("%x", h.Sum(nil))
    timeNowStr := strconv.FormatInt(time.Now().Unix(), 10)
    data := make(url.Values)
    data.Add("appkey", appKey)
    data.Add("xtoken", xtoken)
    // 风控类型 目前只有 marketing
    data.Add("type", "marketing") 
    data.Add("clientip", clientIp)
    data.Add("ts", timeNowStr)
    data.Add("ev", ev)
    data.Add("useragent", useragent)
    data.Add("phone", phoneSha1)
    resp, err := netPost(urlPath, &data)
    if err != nil {
        log.Println(err)
        return nil, err
    }
    return resp, nil
}
// netPost POST请求,可以按照自己实际编程环境替换
func netPost(urlPath string, data *url.Values) (*detectriskResp, error) {
    req, err := http.NewRequest("POST", urlPath, strings.NewReader(data.Encode()))
    req.Header.Add("content-type", "application/x-www-form-urlencoded")
    if err != nil {
        log.Println(err)
        return nil, err
    }
    client := &http.Client{Timeout: 5 * time.Second}
    resp, err := client.Do(req)
    if err != nil || resp.Body == nil {
        log.Println(err)
        return nil, err
    }
    defer resp.Body.Close()
    result, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return nil, err
    }
    respData := &detectriskResp{}
    err = json.Unmarshal(result, respData)
    if err != nil {
        log.Println(err)
        return nil, err
    }
    return respData, nil
}