服务接口文档

更新时间:2019-09-06

1. 取号接口

描述:

APP服务端通过凭证获取用户手机号的接口

请求URL:

http://yuyan.popadshop.com/open/getMobile

请求方式:

POST+json, Content-type设置为application/json

请求参数:

参数名必填说明
accessId控制台生成的访问id
ts时间戳
nonce随机字符串
sign签名
certificateSDK返回的凭证,即token

返回值:

字段类型说明
codestring请求状态码,详见附录
msgstring请求结果说明
datastring加密后的手机号,需以秘钥(AccessSecret)作为key进行AES解密

2. 号码验证

描述:

APP服务端通过凭证验证用户手机号是否为本机号码的接口

请求URL:

http://yuyan.popadshop.com/open/verifyMobile

请求方式:

POST+json, Content-type设置为application/json

请求参数:

参数名必填说明
accessId控制台生成的访问id
ts时间戳
nonce随机字符串
sign签名
certificateSDK返回的凭证

返回值:

字段类型说明
codestring请求状态码,详见附录
msgstring请求结果说明
datastring加密后的验证结果,需以秘钥(AccessSecret)作为key进行AES解密

验证结果说明:

result说明
PASS一致
REJECT不一致
UNKNOWN无法判断

附录

签名(sign)说明:

  1. AccessSecret:接口访问秘钥,从控制台获取
  2. text: 摘要文本,由基本参数拼接,accessId={AccessId}&nonce={nonce}&ts={ts}&key={AccessSecret}
  3. sign: 摘要信息,sha256(text)

状态码(code)说明:

code说明
ok获取成功
parameters_invalid参数异常
sign_invalid签名异常
access_invalid接口访问权限异常
unknown未知异常