津e生活APP(安卓)与web页面交互说明

安卓APP与web类网页交互形式主要有两种:

  • 一是web页javascript调用安卓原生组件
  • 二是安卓原生调用web页面js接口

一、JS调用APP的接口


Changelog

20180723
getJinEPhone由津e生活APP内置实现用户授权隐私信息机制,无需第三方应用通过网页形式提示授权。详见接口说明。


调用方法

津e生活加载第三方应用网站时会生成并嵌入外部交互Javascript对象“jinejs”至web页面,web页面可以直接使用该对象调用各类APP接口。调用方式如:

<script>
alert(jinejs.getJinEUserid("123", "abc"));
alert(jinejs.getJinEPhone("20171028192976180078c7ff15ab01b5ef011b00325b7836277"))
</script>

1. 获取津e生活客户userid

getJinEUserid
web页面使用本接口通过一定授权信息可以获取津e生活客户唯一标志号

  • 接口调用请求说明
参数 是否必须 说明
appid 第三方应用标识
appsecret 第三方应用密钥

测试环境已分配数据{"appid":"123", "appsecret":"abc"}

  • 返回说明
    正确返回JSON数据包
{
  "respCode":"0000",
  "respMsg":"成功",
  "result":{
    "userid":"USERID"
}

2. 获取津e生活客户手机号

getJinEPhone
web页面使用本接口通过userid可以获取津e生活客户手机号
重要:津e生活APP针对首次被请求手机号的user提示是否授权手机号信息给第三方应用,仅当APP用户同意后才成功返回手机号信息

  • 接口调用请求说明
参数 是否必须 说明
appid 第三方应用标识
userid 津e生活客户唯一标识
jsCallbackFunc APP授权完成后回调页面js函数名
  • 接口调用流程
  1. 页面js执行jinejs.getJinEPhone("appid", "userid", "jsCallbackFunc");
  2. 津e生活返回getJinEPhone执行结果;
  3. 津e生活异步弹出授权手机号对话框;
  4. 用户根据情况进行授权;
  5. 用户授权结果通过津e生活异步调用web页面中名为“jsCallbackFunc”的方法进行传输
    例如:
<script>
  jinejs.getJinEPhone("123", resp.result.userid, "getPhoneOk");
  function getPhoneOk(data)
  {
    alert(JSON.parse(data).result.phone);
  }
</script>
  • 返回说明
    正确返回JSON数据包
{
  "respCode":"0000",
  "respMsg":"成功",
  "result":{
    "phone":"PHONE"
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容