1. 描述
查询产品。
2. 调用场景
开发者登录http://consolex.xdua.com后,可以以God角色查询属于所有产品。
3. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | QryDevp | |
URL | https://api.xdua.com/devp | |
Method | GET | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | QRY | |
XduaApiColor | X | 只有持有神产品,才可以创建产品 |
XduaApiAudience | ConsoleX | 只有devp_id为ConsoleX的产品,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 产品直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | 所有注册产品均可以使用 |
XduaApiRoles | God | 必须是Zoon才可以查询角色 |
XduaApiResource | devp | |
XduaApiKparam | where |
常量where |
XduaApiAction | QueryDevp | |
XduaApiRule | QueryDevp | |
XduaApiAstates | 0 | 所有状态都必须是0(STATE_ENABLED) |
XduaApiEnable | true | 接口使能 |
4. URL
5. 请求参数
6. 返回参数
6.1. fields为@all时返回的参数
result.list部分,注意下面的位置表达,result.list[]表示这些字段在list里的每一项里都出现。
名称 | 位置 | 类型 | 示例 | 说明 |
---|---|---|---|---|
id | result.list[] | string | rYub4wrT | 详情的产品ID |
name | result.list[] | string | 产品的名称 | |
avatar | result.list[] | string | 产品图标 | |
brief | result.list[] | string | 产品的描述 | |
state | result.list[] | int | 0 | 产品的状态 |
stato | result.list[] | string | "冻服更新" | 产品的状态说 |
expire | result.list[] | int | 0 | 产品状态过期时间(UNIX时间戳) |
creator_id | result.list[] | string | Dmtv7TrE | 产品创建者ID |
creator_name | result.list[] | string | 辣椒帅 | 产品创建者名字 |
updator_id | result.list[] | string | XiyRvUp3 | 产品最近一次更新者ID |
updator_name | result.list[] | string | 周海潮 | 产品最近一次更新者名字 |
cstamp | result.list[] | string | 2020-01-20 02:19:55 | 产品创建时间 |
istamp | result.list[] | string | 2020-01-20 02:23:24 | 产品最近更新时间 |
6.2. fields为@index时返回的参数
名称 | 位置 | 类型 | 示例 | 说明 |
---|---|---|---|---|
id | result.list[] | string | rYub4wrT | 详情的产品ID |
name | result.list[] | string | 产品的名称 | |
pkey | result.list[] | string | 产品ProductKey |
7. 错误码
错误码来自于error字段,通用错误码参考地球号通用错误码
8. SDK调用
const XduaClient = require('lovearth-xdua-browser-sdk')
const xduaClient = await XduaClient({
LOGIN_TOKEN:"eyJhbGciOi...",//开发者在地球号开发者网站创建的登录令牌
})
/*----------------------------
* 运行如下代码
* 下面的代码是直接可以运行的
*--------------------------*/
api_name = "查询产品";
/*------------------------------------------------------
* 分页查询制造商Minew的所有产品,显示第2页,每页显示20条
*----------------------------------------------------*/
let query_param = {
limit:20,
page:2,
where:{man:"Minew"}
}
/*------------------------------------------------------
* 分页查询不是制造商Minew的所有产品,显示第2页,每页显示20条
*----------------------------------------------------*/
let query_param = {
limit:20,
page:2,
where:{"man[!]":"Minew"}
}
/*------------------------------------------------------
* 分页查询制造商是Minew和xdua.com的所有产品,显示第1页,每页显示20条
*----------------------------------------------------*/
let query_param = {
limit:20,
page:2,
where:{
man:["Minew","xdua.com"],
}
}
/*------------------------------------------------------
* 分页查询产品名字是`虚拟网关`
*----------------------------------------------------*/
let query_param = {
limit:20,
page:1,
where:{
name:"虚拟网关",
}
}
/*------------------------------------------------------
* 分页查询产品名字包含`网关`二字,这是一种模糊查询方式,注意两点
* 1. 要有`[~]`
* 2. 字串模糊的地方要有%,`%网关%`表示前后都可能有其它串,`%网关`表示必须以`网关`结尾。
*----------------------------------------------------*/
let query_param = {
limit:20,
page:1,
where:{
"name[~]":"%网关%",
}
}
const res_api = await xduaClient.qryDevp(query_params)
if(res.error == 0){
console.log("测试成功");
}else{
console.log("测试失败");
console.log(res);
}
文档还没有实现
```
{% sample lang="php" -%}
文档还没有实现
```bash