mobileMove

来自于:开发者立即使用

概述

中国移动www.10086.cn一键登录 Android 接入文档(内含Android)

APICloud 的 mobileMove 模块是一个原生代码模块。

模块接口

getinit

获取本机号码校验token

getinit({}, callback(ret))

params

appid:

  • 类型:字符串
  • 描述:(必选)应用的AppID。

appkey:

  • 类型:字符串
  • 描述:(必选)应用密钥。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status:       //布尔值,接口调用成功,false:失败,true:成功。    
    authType://整数,登录类型。
    authTypeDes:    //字符串,    登录类型中文描述。
    token:    //字符串,    成功返回:临时凭证,token有效期2min,一次有效,同一用户(手机号)10分钟内获取token且未使用的数量不超过30个。
    resultCode: //整数,SDK返回码,“103000”为成功,其它返回码见文档底部。
}

示例代码

   function getinit(){
        var json={
            "appid":"3000118*****",
            "appkey":"1CCEBD8*****11DE2AF6B********"
        }
        var mobileMove = api.require('mobileMove');
        mobileMove.getinit(json, function(ret) {
            alert(JSON.stringify(ret)); 
        });
    };

可用性

Android系统

可提供的1.0.0及更高版本

getNetworkType

获取网络状态和运营商类型

getNetworkType({}, callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status:       //布尔值,接口调用成功,false:失败,true:成功。
    operatortype: //字符串,运营商类型:1.移动流量;2.联通流量;3.电信流量
    networktype: //字符串,网络类型:0.未知;1.流量;2.wifi;3.数据流量+wifi
}

示例代码

   function getNetworkType(){
        var mobileMove = api.require('mobileMove');
        mobileMove.getNetworkType({}, function(ret) {
            alert(JSON.stringify(ret)); 
        });
    };

可用性

Android系统

可提供的1.0.0及更高版本

getPhoneInfo

在用户正式授权给开发者使用本机号码登录前,开发者可以提前调取预取号方法,获知当前用户的终端状态和网络环境是否可以从网关获取号码。

为了保证SDK取号成功率,开发者在取号前必须保证: 1、应用必须提前获取用户手机READ_PHONE_STATE权限(用于判断双卡、换卡)。 2、运营商目前只支持中国移动2/3/4G和中国电信4G,开发者在调用取号方法前,可以预先判断当前用户的运营商类型和网络制式,仅针对SDK目前支持的运营商和网络制式使用一键登录功能。 3、网关取号必须在数据流量打开的情况下进行,因此,用户如果关闭数据流量或者未授权应用数据流量使用权限时,将无法成功取号。

getPhoneInfo({}, callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status:       //布尔值,接口调用成功,false:失败,true:成功。
    desc:    //布尔值    成功标识,true为成功。
    resultCode://整数,SDK返回码,“103000”为成功,其它返回码见文档底部。

}

示例代码

   function getPhoneInfo(){
        var mobileMove = api.require('mobileMove');
        mobileMove.getPhoneInfo({}, function(ret) {
            alert(JSON.stringify(ret)); 
        });
    };

可用性

Android系统

可提供的1.0.0及更高版本

loginAuth

应用调用一键登录方法,SDK将会拉起用户授权页面,用户授权后,SDK将返回token给应用客户端。

loginAuth({}, callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: //布尔值,接口调用成功,false:失败,true:成功。
    resultDesc: //字符串,失败时返回:返回错误码说明
    authType: //字符串,认证类型:0:其他;1:WiFi下网关鉴权;2:网关鉴权;3:短信上行鉴权;7:短信验证码登录
    authTypeDec:     //字符串,    认证类型描述,对应authType
    token: //字符串,    成功时返回:临时凭证,token有效期2min,一次有效;同一用户(手机号)10分钟内获取token且未使用的数量不超过30个
    openId:     //字符串,    成功时返回:用户身份唯一标识
    resultCode://整数,SDK返回码,“103000”为成功,其它返回码见文档底部。
}

示例代码

   function loginAuth(){
        var mobileMove = api.require('mobileMove');
        mobileMove.loginAuth({}, function(ret) {
            alert(JSON.stringify(ret)); 
        });
    };

可用性

Android系统

可提供的1.0.0及更高版本

getPhoneNumber

获取手机号码,前提是调用loginAuth返回openId信息。

getPhoneNumber({}, callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: //布尔值,接口调用成功,false:失败,true:成功。
    inresponseto://字符串,对应的请求消息中的msgid。
    systemtime://字符串,响应消息发送的系统时间,精确到毫秒,共17位,格式:20121227180001165。
    resultcode://整数,SDK返回码,“103000”为成功,其它返回码见文档底部。
    msisdn:  //字符串,表示用户手机号码,如果加密方式为RSA,应用需要用私钥进行解密。
}

示例代码

   function getPhoneNumber(){
        var mobileMove = api.require('mobileMove');
        mobileMove.getPhoneNumber({}, function(ret) {
            alert(JSON.stringify(ret)); 
        });
    };

SDK返回码

//    103000    :    成功
//    102101    :    无网络
//    102102    :    网络异常
//    102103    :    未开启数据网络
//    102121    :    用户取消登录
//    102203    :    输入参数错误
//    102223    :    数据解析异常
//    102507    :    请求超时
//    102508    :    数据网络切换失败
//    200002    :    手机未安装sim卡
//    200005    :    用户未授权(READ_PHONE_STATE)
//    200006    :    用户未授权(SEND_SMS)
//    200007    :    authType仅使用短信验证码认证
//    200008    :    1. authType参数为空;2. authType参数不合法;
//    200009    :    应用合法性校验失败(包名包签名未填写正确)
//    200010    :    预取号时imsi获取失败或者没有sim卡
//    200012    :    取号失败,跳短信验证码登录
//    200013    :    短信上行发送短信失败(短信上行)
//    200014    :    手机号码格式错误(短验)
//    200015    :    短信验证码格式错误
//    200016    :    更新KS失败
//    200017    :    非移动卡不支持短信上行
//    200018    :    不支持网关登录
//    200019    :    不支持短信验证码登录
//    200020    :    用户取消登录
//    200021    :    数据解析异常(服务器异常可重新尝试)
//    200022    :    无网络状态
//    200023    :    请求超时
//    200024    :    数据网络切换失败
//    200025    :    未知错误一般出现在线程捕获异常,请配合异常打印分析
//    200026    :    输入参数错误
//    200027    :    预取号时未开启数据流量
//    200028    :    网络请求出错(根据日志分析)
//    200029    :    请求出错,上次请求未完成
//    200030    :    没有初始化参数
//    200031    :    生成token失败
//    200032    :    KS缓存不存在
//    200033    :    复用中间件获取Token失败
//    200034    :    预取号token失效
//    200035    :    协商ks失败
//    200036    :    预取号失败
//    200037    :    获取不到openid
//    200038    :    电信重定向失败
//    200039    :    电信取号接口返回失败
//    200040    :    UI资源加载异常
//    200042    :    授权页弹出异常

可用性

Android系统

可提供的1.0.0及更高版本