简要描述:

  • 获取校验结果接口

请求URL:

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

请求方式:

  • POST

数据类型:
application/json

参数:

参数名 必选 类型 说明
process_id string 客户端sdk返回的流水号
sign string 用户签名,用于校验用户身份,具体生成方式见身份校验部分
accesscode string 客户端sdk返回的标记,用于获取标记对应的校验结果
phone string c端用户手机号, 11位手机号
timestamp string 当前时间(单位为毫秒)

请求示例

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

返回示例

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

返回参数说明

参数名 类型 说明
status int 状态码,200为成功,具体信息见状态码表
result string 请求成功时,表示校验结果,”0” 表示匹配,页面输入的手机号与当前流量卡号一致;”1” 表示不匹配,页面输入的手机号与当前流量卡号不一致
error_msg string 请求失败时,返回对应状态码的描述

状态码

状态码 描述
200 请求成功
500 从运营商获取结果失败
2000 process_id为空
2001 sign为空
2002 accesscode为空
2003 phone为空
2004 process_id不合法(32位)
2005 错误的timestamp
2104 sign错误
3101 未查询到对应的app_id
3102 未查询到对应的process_id
3105 流水号已经被使用过
3200 token失效

身份校验:

app_id、app_key在账户后台【身份验证–>OnePass–>设置】页面查看。

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

使用app_key进行签名。将结果转换为16进制。

示例:

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

签名结果为:

6ef12cd35800607896a0e82b2a53955d679f97ff63e2a17954ddfbd3f7647501