概述
cmbc-miniapp-jssdk是面向民生手機銀行小程序開發(fā)者提供的網(wǎng)頁開發(fā)工具包。
接口調(diào)用說明
cmbc-miniapp-jssdk默認導(dǎo)出cmbc實例,所有的接口通過該實例對象來調(diào)用。
安裝
# --registry 為 npm 私有倉庫的地址
$ npm install cmbc-miniapp-jssdk --registry=http://xxx.x.x.x
import cmbc from 'cmbc-miniapp-jssdk'
cmbc-miniapp-jssdk接口定義
canIUse()
判斷小程序的API是否在當(dāng)前版本可用。
參數(shù) string
使用 ${API} 方式來調(diào)用
返回值 boolean
當(dāng)前版本是否可用
示例代碼:
const boolean = cmbc.canIUse('request')
console.log(boolean)
請求:request()
客戶端發(fā)起一個 HTTPS請求
參數(shù)
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
url | string | 是 | 開發(fā)者服務(wù)器接口地址 | |
data | string/object | 否 | 請求的參數(shù) | |
method | string | POST | 否 | HTTP 請求方法 |
dataType | string | json | 否 | 返回的數(shù)據(jù)格式 |
responseType | string | text | 否 | 響應(yīng)的數(shù)據(jù)類型 |
encrypted | boolean/string | false | 否 | 是否加密 |
success | function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
fail | function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) | |
complete | function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行) |
method 參數(shù)的合法值
值 | 說明 |
---|---|
GET | HTTP 請求 GET |
POST | HTTP 請求 POST |
dataType 參數(shù)的合法值
值 | 說明 |
---|---|
json | 返回的數(shù)據(jù)為 JSON,返回后會對返回的數(shù)據(jù)進行一次 JSON.parse |
其他 | 不對返回的內(nèi)容進行 JSON.parse |
responseType 參數(shù)的合法值
值 | 說明 |
---|---|
text | 響應(yīng)的數(shù)據(jù)為文本 |
encrypted 參數(shù)的合法值
值 | 說明 |
---|---|
false或者空 | 不加密 |
true | 加密,登錄后交易使用的加密 |
005 | 加密,登錄前交易使用的加密 |
success 回調(diào)參數(shù):
屬性 | 類型 | 說明 |
---|---|---|
data | string/Object/Arraybuffer | 開發(fā)者服務(wù)器返回的數(shù)據(jù) |
statusCode | number | 開發(fā)者服務(wù)器返回的 HTTP 狀態(tài)碼 |
header | Object | 開發(fā)者服務(wù)器返回的 HTTP Response Header |
fail 回調(diào)參數(shù):
屬性 | 類型 | 說明 |
---|---|---|
error | Object | 開發(fā)者服務(wù)器返回的錯誤信息 |
示例代碼:
import cmbc from 'cmbc-miniapp-jssdk'
cmbc.request({
url: 'test.php', // 僅為示例,并非真實的接口地址
data: {
x: '',
y: ''
},
success(res) {
const { data, statusCode } = res
console.log(data)
},
fail(res) {
const { error } = res
console.log(error)
}
})
設(shè)置導(dǎo)航欄標(biāo)題:setNavigationBarTitle()
動態(tài)設(shè)置當(dāng)前頁面的標(biāo)題
參數(shù):
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
title | string | 否 | 標(biāo)題 | |
success | function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
fail | function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) |
回調(diào)參數(shù):無
示例代碼:
cmbc.setNavigationBarTitle({
title: '當(dāng)前頁面'
})
關(guān)閉本頁面:navigationCloseThisPage()
關(guān)閉當(dāng)前網(wǎng)頁窗口
參數(shù)
無
回調(diào)參數(shù):無
示例代碼:
cmbc.navigationCloseThisPage()
調(diào)用接口獲取登陸憑證: login()
調(diào)用接口獲取登錄憑證(code)。通過憑證進而換取用戶登錄態(tài)信息,包括用戶的唯一標(biāo)識(openid)及本次登錄的會話密鑰(session_key)等。
參數(shù)
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
success | function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
fail | function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) | |
complete | function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行) |
success 回調(diào)參數(shù):
屬性 | 類型 | 說明 |
---|---|---|
code | string | 用戶登錄憑證 |
示例代碼:
cmbc.login({
success: (res) => {
// 成功后的回調(diào)
const { code } = res
},
})
獲取當(dāng)前的地理位置: getLocation()
獲取當(dāng)前的地理位置
參數(shù)
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
success | function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
fail | function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) | |
complete | function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行) |
success 回調(diào)參數(shù):
屬性 | 類型 | 說明 |
---|---|---|
latitude | number | 緯度,范圍為 -90~90,負數(shù)表示南緯 |
longitude | number | 經(jīng)度,范圍為 -180~180,負數(shù)表示西經(jīng) |
示例代碼:
cmbc.getLocation({
success: (res) => {
// 成功后的回調(diào)
const { latitude, longitude } = res
},
})