通用协议接口调用
通用协议接口是千牛提供的与业务能力相关的一系列接口。
API 查询
API 调用
QN.app.invoke(options)
发起通用协议接口调用
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
options |
Object |
|
选项 |
options.api |
String |
|
通用协议接口名称 |
options.query |
Object |
|
请求参数,具体查看每个通用协议接口所需的参数 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Any |
|
响应对象,具体查看每个通用协议接口返回的结果 |
调用示例
QN.app.invoke({
api: 'itemList',
query: {
itemStatus: 'onsale'
}
}).then(result => {
console.log(result);
}, error => {
console.log(error);
});
QN.app.name
String
应用名称
返回值 |
含义 |
qianniu |
千牛 |
taobao |
淘宝 |
tmall |
天猫 |
alipay |
支付宝 |
1688 |
1688 |
wangxin |
旺信 |
dingtalk |
钉钉 |
QN.app.group
String
应用所属的族系
返回值 |
含义 |
AliApp |
阿里系App |
Other |
其他 |
QN.app.version
Object
应用版本对象
QN.app.version.value
String
千牛版本
QN.app.version.gt(version)
判断版本是否大于某个版本
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
version |
Number String |
|
需要对比的版本号 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Boolean |
|
true 为判断成立, false 为判断不成立 |
调用示例
QN.app.version.gt(4);
QN.app.version.gt(6);
QN.app.version.gt('4.4.4');
QN.app.version.gt('6.6.6');
QN.app.version.gte(version)
判断版本是否大于或等于某个版本
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
version |
Number String |
|
需要对比的版本号 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Boolean |
|
true 为判断成立, false 为判断不成立 |
调用示例
QN.app.version.gte(4);
QN.app.version.gte(5);
QN.app.version.gte(6);
QN.app.version.gte('4.4.4');
QN.app.version.gte('5.0.0');
QN.app.version.gte('6.6.6');
QN.app.version.eq(version)
判断版本是否等于某个版本
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
version |
Number String |
|
需要对比的版本号 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Boolean |
|
true 为判断成立, false 为判断不成立 |
调用示例
QN.app.version.eq(5);
QN.app.version.eq(6);
QN.app.version.eq('5.0.0');
QN.app.version.eq('6.6.6');
QN.app.version.lt(version)
判断版本是否小于某个版本
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
version |
Number String |
|
需要对比的版本号 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Boolean |
|
true 为判断成立, false 为判断不成立 |
调用示例
QN.app.version.lt(4);
QN.app.version.lt(6);
QN.app.version.lt('4.4.4');
QN.app.version.lt('6.6.6');
QN.app.version.lte(version)
判断版本是否小于或等于某个版本
API 调用入参
名称 |
类型 |
是否可选 |
含义 |
version |
Number String |
|
需要对比的版本号 |
API 响应结果
名称 |
类型 |
是否必须返回 |
含义 |
result |
Boolean |
|
true 为判断成立, false 为判断不成立 |
调用示例
QN.app.version.lte(4);
QN.app.version.lte(5);
QN.app.version.lte(6);
QN.app.version.lte('4.4.4');
QN.app.version.lte('5.0.0');
QN.app.version.lte('6.6.6');