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

results matching ""

    No results matching ""