基礎開放能力 – 授權
getAuthCode
通過呼叫 jkos.getAuthCode 在需要取得使用者的授權資料時,喚起街口原生的授權頁面。
使用方法
jkos.getAuthCode(data, callback);
<button id="test">getAuthCode</button>
<script>
document.querySelector('#test').addEventListener('click', () => {
jkos.getAuthCode ({
clientId : 'string' ,
scopes : ['userInfo'],
onSuccess: (authCode) => {},
onError: (e) => {
console.log(e.error)
console.log(e.errorMessage)
},
onRejectAuth: () => {}
}, (res) => {
console.log(res.error)
console.log(res.errorMessage)
})
});
</script>
入參說明
必須 第一個參數:data
參數 | 必填 | 型態 | 說明 |
---|---|---|---|
clientId | 是 | string | Client ID |
scopes | 是 | string | 需要提供的權限屬性,可使用 Array 指定多個 scope |
onSuccess | 是 | function | 取得 authCode 成功的回呼函式 |
onError | 否 | function | 取得 authCode 失敗的回呼函式 |
onRejectAuth | 否 | function | 當使用者拒絕授權時,點擊 < (返回)或 X (關閉),會呼叫的函式 |
非必須 第二個參數: callback
返回設定函式成功與否,也可使用 async/await
取代 callback
參數 | 型態 | 說明 |
---|---|---|
error | number | 錯誤碼 – 詳情請參見錯誤碼說明 |
errorMessage | string | 此描述為相關錯誤的 ASCII 編碼可讀文字 |
錯誤碼回覆
代碼 | 說明 |
---|---|
15 | 系統不支援 |
16 | 格式錯誤 |