概述

本文是极验无感本机认证产品的服务端API接口说明，供开发者做接入使用。无感本机认证包含OneLogin（一键登录 APP）、OnePass（本机号码认证APP）和OnePassAPI（本机号码认证H5）三个能力。

如APP使用一键登录功能，则服务端相应对接OneLogin（一键登录APP）接口即可。

如APP使用本机号码认证功能，则服务端相应对接OnePass（本机号码认证APP）接口即可。

如H5或者小程序使用本机号码认证功能，则服务端相应对接OnePassAPI（本机号码认证H5）接口即可。

OneLogin（一键登录APP）

1、 接口地址和说明

请求URL：
https://onelogin.geetest.com/check_phone

请求方式：

• POST

数据类型：
application/json

2、 接口请求参数

请求参数：

请求示例：

curl -H "Content-Type: application/json" -d '{"token": "客户端返回用于获取结果的token", "sign": "生成的用户签名", "process_id": "客户端返回的流水号", "authcode": "客户端返回的电信校验码", "is_phone_encode": true, "timestamp": "当前时间"}' https://onelogin.geetest.com/check_phone

3、 接口返回参数

返回参数说明：

OnePass（本机号码认证APP）

1、 接口地址及说明

请求URL：

• https://onepass.geetest.com/v2.0/check_gateway

请求方式：

• POST

数据类型：
application/json

2、 接口请求参数

请求参数：

请求示例

curl -H "Content-Type: application/json"  -d '{"phone": "手机号", "accesscode": "客户端返回用于获取结果的token", "sign": "生成的用户签名", "process_id": "客户端返回的流水号","timestamp": "当前时间"}' https://onepass.geetest.com/v2.0/check_gateway

3、 接口返回参数

返回参数说明：

本机号返回示例

{
    "status": 200,
    "result": "0"
}

非本机号返回示例

{
    "status": 200,
    "result": "1"
}

OnePass API（本机号码认证H5）

1、 接口地址及说明

请求URL：

• https://onepass.geetest.com/web/check_gateway

请求方式：

• POST

数据类型：
X-WWW-FORM-URLENCODED

2、 接口请求参数

请求参数：

请求示例

curl -d "sign=生成的用户签名&process_id=客户端返回的流水号&timestamp=当前时间&phone=校验用的手机号" https://onepass.geetest.com/web/check_gateway

3、 接口返回参数

返回参数说明：

本机号返回示例

{
    "status": 200,
    "data": {
        "result": "0"
    }
}

非本机号返回示例

{
    "status": 200,
    "data": {
        "result": "1"
    }
}

Sign生成和手机号加密说明

1、 Sign生成方式说明

1.将app_id, 以及当前时间戳（毫秒为单位）通过”&&”连接。（app_id + ‘&&’ + timestamp）

2.使用app_key进行hmac-sha256签名。将结果转换为16进制(注意：为小写)。

示例:

app_id： ‘zoekwui1hnmg49x5fwzf5la0ml5dziwn’
app_key： ‘gywzffojtnzl0vd6kcut8fcgyud5wg49’
时间戳： ‘1542355862990’

签名结果为：

6ef12cd35800607896a0e82b2a53955d679f97ff63e2a17954ddfbd3f7647501

demo下载：

Java, Python, JS, PHP

2、 手机号加密方式说明

直接对手机号使用AES（密钥app_key）加密，结果转换为16进制。

示例：

手机号：13333333333

app_key： ‘gywzffojtnzl0vd6kcut8fcgyud5wg49’

加密结果：’be28dea08ee543320b1ef9e1bceb51e4’

demo下载：

Java, Python, JS, PHP