安卓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函数名 |
- 接口调用流程
- 页面js执行jinejs.getJinEPhone("appid", "userid", "jsCallbackFunc");
- 津e生活返回getJinEPhone执行结果;
- 津e生活异步弹出授权手机号对话框;
- 用户根据情况进行授权;
- 用户授权结果通过津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"
}