本机号码认证
服务端调用前提条件:
服务端调用前提条件:
1、认证方案已经配置;2、认证sdk移动端已经集成;3、阿里云市场已经购买授权,已获取阿里云授权 appcode,appkey, appsecret (服务端调用时配置),可点击链接并登录阿里云管理控制台查看(https://market.aliyun.com/products/57124001/cmapi00036707.html )。
1、请求
请求地址
https://verify5.market.alicloudapi.com/api/v1/mobile/verify?appkey=*****&verifyId=*****危险
订购特殊客户按量计价商品的开发者不要请求以上资源包商品地址,请联系您的客服人员
*appkey为用户在友盟注册的应用分配的appkey, 与前提条件中阿里云授权的appkey不一样;*该appkey可在友盟管理控制台的“认证管理”中获取,位置分别如下:
集成时appkey必须传递。-渠道商集成时若未传递appkey,会导致结果获取不正确;-非渠道商集成时若未传递appkey,会影响用量统计;参考 服务端签名 demo 代码时,host = verify5.market.alicloudapi.compath = /api/v1/mobile/verifyappkey作为query参数传输_verifyId作为query参数传输(可选)如果开启超限管理功能, verifyId参数必传,否则设备阈值设定不生效(值通过SDK getVerifyId接口获取回传服务端 )
请求方法
POST请求头部
Content-Type: application/json; charset=UTF-8
//请求体类型。
Accept: application/json
//请求响应体类型,部分 API 可以根据指定的响应类型来返回对应数据格式,建议手动指定此请求头,如果不设置,部分 HTTP 客户端会设置默认值 */*,导致签名错误。
X-Ca-Version:1
// API 版本号,目前所有 API 仅支持版本号『1』,可以不设置此请求头,默认版本号为『1』。
X-Ca-Signature-Headers: X-Ca-Request-Mode,X-Ca-Version,X-Ca-Stage,X-Ca-Key,X-Ca-Timestamp
//参与签名的自定义请求头,服务端将根据此配置读取请求头进行签名,此处设置不包含 Content-Type、Accept、Content-MD5、Date 请求头,这些请求头已经包含在了基础的签名结构中,详情参照请求签名说明文档。
X-Ca-Stage: RELEASE
X-Ca-Key:60022326
//请求的 阿里云AppKey,通过云市场等渠道购买的 API 默认已经给 APP 授过权,阿里云所有云产品共用一套 AppKey 体系,删除 ApppKey 请谨慎,避免影响到其他已经开通服务的云产品。
X-Ca-Timestamp:1471864864235
//请求的时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟。
X-Ca-Nonce:b931bc77-645a-4299-b24b-f3669be577ac
//请求唯一标识,15分钟内 AppKey+API+Nonce 不能重复,与时间戳结合使用才能起到防重放作用。
X-Ca-Signature:FJleSrCYPGCU7dMlLTG+UD3Bc5Elh3TV3CWHtSKh1Ys=
//请求签名,使用方参照签名机制生成。请求体
//HTTP Request Body json
{
"token":"******",
"phoneNumber":"159********"
}2、响应
状态码
200,400,500
http状态码,大于等于200小于300表示成功;大于等于400小于500为客户端错误;大于500为服务端错误;响应头
X-Ca-Request-Id:7AD052CB-EE8B-4DFD-BBAF-EFB340E0A5AF
//请求唯一 ID,请求一旦进入 API 网关应用后,API 网关就会生成请求 ID 并通过响应头返回给客户端,建议客户端与后端服务都记录此请求 ID,可用于问题排查与跟踪。
X-Ca-Error-Message:InvalidUrl
//API网关返回的错误消息,当请求出现错误时 API 网关会通过响应头将错误消息返回给客户。响应体
成功返回结果示例:
{"success":true,"data":{"verifyResult":"PASS","score":0.8,"activeScore":0.0},"code":2003,"message":"gain mobile's result and two evaluation score","requestId":"20A1EC72-FA8B-464A-B162-A00BF4E25299"}
失败返回结果示例:
{"success":false,"data":null,"code":-2219,"message":"AccessCode参数非法","requestId":"7AD052CB-EE8B-4DFD-BBAF-EFB340E0A5AF"}