安卓APP與web類網頁交互形式主要有兩種:
- 一是web頁javascript調用安卓原生組件
- 二是安卓原生調用web頁面js接口
一、JS調用APP的接口
Changelog
20180723
getJinEPhone由津e生活APP內置實現(xiàn)用戶授權隱私信息機制,無需第三方應用通過網頁形式提示授權。詳見接口說明。
調用方法
津e生活加載第三方應用網站時會生成并嵌入外部交互Javascript對象“jinejs”至web頁面,web頁面可以直接使用該對象調用各類APP接口。調用方式如:
<script>
alert(jinejs.getJinEUserid("123", "abc"));
alert(jinejs.getJinEPhone("20171028192976180078c7ff15ab01b5ef011b00325b7836277"))
</script>
1. 獲取津e生活客戶userid
getJinEUserid
web頁面使用本接口通過一定授權信息可以獲取津e生活客戶唯一標志號
- 接口調用請求說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 第三方應用標識 |
| appsecret | 是 | 第三方應用密鑰 |
測試環(huán)境已分配數(shù)據(jù){"appid":"123", "appsecret":"abc"}
- 返回說明
正確返回JSON數(shù)據(jù)包
{
"respCode":"0000",
"respMsg":"成功",
"result":{
"userid":"USERID"
}
2. 獲取津e生活客戶手機號
getJinEPhone
web頁面使用本接口通過userid可以獲取津e生活客戶手機號
重要:津e生活APP針對首次被請求手機號的user提示是否授權手機號信息給第三方應用,僅當APP用戶同意后才成功返回手機號信息
- 接口調用請求說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 第三方應用標識 |
| userid | 是 | 津e生活客戶唯一標識 |
| jsCallbackFunc | 是 | APP授權完成后回調頁面js函數(shù)名 |
- 接口調用流程
- 頁面js執(zhí)行jinejs.getJinEPhone("appid", "userid", "jsCallbackFunc");
- 津e生活返回getJinEPhone執(zhí)行結果;
- 津e生活異步彈出授權手機號對話框;
- 用戶根據(jù)情況進行授權;
- 用戶授權結果通過津e生活異步調用web頁面中名為“jsCallbackFunc”的方法進行傳輸
例如:
<script>
jinejs.getJinEPhone("123", resp.result.userid, "getPhoneOk");
function getPhoneOk(data)
{
alert(JSON.parse(data).result.phone);
}
</script>
- 返回說明
正確返回JSON數(shù)據(jù)包
{
"respCode":"0000",
"respMsg":"成功",
"result":{
"phone":"PHONE"
}