WHERES参数
在所有的遍历接口中都包含wheres参数用于指定遍历操作时的条件。
wheres参数本身为一个json对象数组,一个对象表示一个条件,条件与条件之间是AND关系; 其次由于wheres参数的位置在URL中,如果直接填写json到URL中可能会有因为URL safe导致出现问题。所以在将wheres放入URL中之前,需要将wheres进行一次base64和urlencode。
wheres 条件对象结构
参数 | 类型 | 说明 |
---|---|---|
+ k | string | 目标键的名称,不同的接口能填入的k和其描述会在接口详情中给出 |
+ o | string | 操作,详见下方说明 |
+ v | - | 值,与k对应的值类型相关 |
o 可以填入的值:
参数 | 效果 | 备注 |
---|---|---|
eq | 等于 | |
ne | 不等于 | |
lt | 小于 | |
lte | 小于或等于 | |
gt | 大于 | |
gte | 大于或等于 | |
like | 模糊匹配,类似sql中的LIKE | |
in | 在列表中 | v的类型应该为一个json数组,数组中内容类型和k值的类型一致 |
ni | 不在列表中 | v的类型应该为一个json数组,数组中内容类型和k值的类型一致 |
示例
示例使用到的接口为遍历设备接口
base64前:
[
{ "k": "region", "o": "like", "v": "%四川%" },
{ "k": "state", "o": "eq", "v": 0 },
{ "k": "series_name", "o": "in", "v": [ "RM", "RX", "R3" ] }
]
base64并urlencode后:
WwogICAgeyAiayI6ICJyZWdpb24iLCAibyI6ICJsaWtlIiwgInYiOiAi5Zub5bedIiB9LAogICAgeyAiayI6ICJzdGF0ZSIsICJvIjogImVxIiwgInYiOiAwIH0sCiAgICB7ICJrIjogInNlcmllc19uYW1lIiwgIm8iOiAiaW4iLCAidiI6IFsgIlJNIiwgIlJYIiwgIlIzIiBdIH0KXQ%3D%3D