YesApi 接口文档

1701 创建新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Create

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Create

接口描述： 增 在直连数据库表添加一条新数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
data字符串JSON格式可选创建时的初始化数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.Create&model_name=article&data={"title":"123456"}&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.Create&model_name=article&data_title=123456&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "id": 4
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1创建失败(不符合表字段要求，或表字段不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.id整型新创建数据的自增ID
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1702 创建非重复新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/CheckCreate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.CheckCreate

接口描述： 增 在直连数据库表添加一条【非重复】新数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
data字符串JSON格式可选创建时的初始化数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）
check_field字符串用,分割必须待检测的字段。注意：data数据中必须包含此字段的数据，用作检测重复的依据。多个检测字段用英文逗号分割。例如：check_field=name,age，表示同时检测名字和年龄。请留意字段类型的相等性判断，如字符串类型的字段不能在data参数中传整型参数。
model_return_data布尔型可选false是否返回新创建或原来的数据，model_return_data=1 返回，model_return_data=0 不返回

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.CheckCreate&model_name=article&data={"title":"abc","content":"something"}&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.CheckCreate&model_name=article&data_title=abc&data_content=something&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "id": 4
    },
    "msg": ""
}


如果数据已经存在，则返回：
{
    "ret": 200,
    "data": {
        "err_code": 3,
        "err_msg": "数据已存在，不再创建",
        "id": 11
    }
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1创建失败(不符合表字段要求，或表字段不存在)；3、数据已存在，不再创建
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.id整型新创建数据的自增ID/或原来数据的ID
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1703 批量创建新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiCreate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiCreate

接口描述： 增 批量导入多条新数据，导入完毕后会返回导入的概况

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
datas字符串JSON格式必须批量导入的数据。特别注意！这是复数datas，即需要传递是的单个创建时的数组的数组。格式为JSON，即：datas=[单个创建时的数据1, 单个创建时的数据2, ...]。一次最多只允许导入1000条数据。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiCreate&model_name=article&datas=[{"title":"文章标题1"},{"title":"文章标题2"}]&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 2,
        "import_num": 2,
        "not_import_num": 0,
        "details": [
            {
                "id": 1,
                "new_id": 10,
                "msg": "导入成功"
            },
            {
                "id": 2,
                "new_id": 11,
                "msg": "导入成功"
            }
        ]
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0导入成功；1导入失败(如表不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型本次导入的总数量
data.import_num整型成功导入的数量
data.not_import_num整型导入失败的数量
data.details字符串导入过程中的操作纪录
data.details[].id整型导入的ID，从1开始
data.details[].new_id整型数据添加成功时的纪录ID，失败时为0
data.details[].msg字符串导入的结果
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1704 批量极速创建新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiFastCreate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiFastCreate

接口描述： 增 批量极速导入多条新数据，速度很快但无明细，此接口可用于批量导入数据，适用于数据初始化和还原。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
datas字符串JSON格式必须批量导入的数据。特别注意！这是复数datas，即需要传递是的单个创建时的数组的数组。格式为JSON，即：datas=[单个创建时的数据1, 单个创建时的数据2, ...]。一次最多只允许导入1000条数据。
is_ignore布尔型可选true是否启用IGNORE，1是0否，其中：
  • 若为是，则在创建时判断是否存在相同的数据，并且重复时忽略跳过，最终结果是部分或全部成功创建；
  • 若为若，则不管是否存均进行创建，如果有唯一索引或其他原因导致失败将会全部创建不成功。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0导入成功；1导入失败(如表不存在)
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型本次导入的总数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1705 精确更新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Update

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Update

接口描述： 改 根据ID，更新直连数据库表的数据，更新的字段需要先存在。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
id整型必须最小：1数据ID，例如：1，2，3，……
data字符串JSON格式可选待更新的数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.Update&model_name=article&id=5&data={"state":2}&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.Update&model_name=article&id=5&data_state=2&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": ""
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，更新失败(不符合表字段要求，或表字段不存在)；3更新失败(数据已删除或不存在)
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1706 批量ID更新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiUpdate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiUpdate

接口描述： 改 根据多个ID，批量更新自定义数据表单中的数据，更新的字段需要先存在。对系统保留表字段（id, uuid, add_time, update_time, ext_data）的更新将会被忽略。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
idsids必须最大：500多个ID，使用英文逗号分割，例如：ids=1,2,3
data字符串JSON格式可选待更新的数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiUpdate&model_name=article&ids=36,37&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "update_total": 2
    },
    "msg": "小白开放接口：App.SuperTable.MultiUpdate"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，更新失败(不符合表字段要求，或表字段不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；3更新失败(数据已删除或不存在)
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.update_total整型成功更新的数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1707 自由更新数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeUpdate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeUpdate

接口描述： 改 功能更强大的更新操作，可以根据自定义的多个条件（AND或者OR），更新指定的数据。为防止误更新全表数据，必须至少有一个有效条件。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
data字符串JSON格式可选待更新的数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeUpdate&model_name=article&where=[["title","=","123456"]]&data={"title":"654321"}&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeUpdate&model_name=article&where_title=123456&data_title=654321&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "update_rows": 1
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，更新失败(不符合表字段要求，或表字段不存在)；3无数据更新
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.update_rows整型更新的行数，0表示无任何更新
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1708 精确取数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Get

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Get

接口描述： 查 根据ID，获取直连数据库表中的数据

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
id整型必须最小：1数据ID，例如：1，2，3，……

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.Get&model_name=article&id=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "id": 1,
            "uuid": "",
            "add_time": "2017-11-23 23:35:13",
            "update_time": "2018-06-27 22:27:18",
            "ext_data": null,
            "title": "PHP程序员历险记",
            "content": "PHP<a>test</a>（外文名:PHP: Hypertext Preprocessor，中文名：“超文本预处理器”）是一种通用开源脚本语言。PHP<a>test</a>（外文名:PHP: Hypertext Preprocessor，中文名：“超文本预处理器”）是一种通用开源脚本语言。PHP<a>test</a>（外文名:PHP: Hypertext Preprocessor，中文名：“超文本预处理器”）是一种通用开源脚本语言。",
            "post_time": "1970-01-01 00:00:00",
            "view_times": "5",
            "state": "1"
        }
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(符合表字段要求，或表字段不存在)；3获取失败(数据已删除或不存在)
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取的数据，并返回全部字段的数据
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1709 批量ID取数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiGet

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiGet

接口描述： 查 根据批量ID，批量获取自定义数据表单中的数据

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
idsids必须最大：500多个ID，使用英文逗号分割，例如：ids=1,2,3

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiGet&model_name=article&ids=36,37&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "list": [
        {
            "id": 36,
            "uuid": "",
            "add_time": "2019-04-06 17:25:13",
            "update_time": "2019-05-01 20:49:53",
            "ext_data": null,
            "title": "PHP程序员历险记223",
            "content": "<p><em>PHP</em>（外文名:<em>PHP</em>: Hypertext Preprocessor，中文名：“超文本预处理器”）</p>",
            "post_time": "2020-07-29 06:30:00",
            "view_times": "0",
            "state": "0",
            "test_time": "2019-04-06 17:25:13",
            "zhaiyao": ""
        },
        {
            "id": 37,
            "uuid": "",
            "add_time": "2019-06-07 10:00:23",
            "update_time": null,
            "ext_data": null,
            "title": "来吧~",
            "content": null,
            "post_time": "1970-01-01 00:00:00",
            "view_times": "0",
            "state": "0",
            "test_time": "2019-06-07 10:00:23",
            "zhaiyao": "来吧~"
        }
        ]
    },
    "msg": "小白开放接口：App.SuperTable.MultiGet"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(符合表字段要求，或表字段不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.list字符串获取的数据，没有任何数据时为空数组，如果未找到ID对应的数据则没有任何元素
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1710 精确删除数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Delete

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Delete

接口描述： 删 根据ID，删除直连数据库表中的数据

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
id整型必须最小：1数据ID，例如：1，2，3，……

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.Delete&model_name=article&id=4&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": ""
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功删除；1开发类错误，删除失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1711 批量ID删除数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiDelete

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiDelete

接口描述： 删 根据多个ID，批量删除自定义数据表单中的数据

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
idsids必须最大：500多个ID，使用英文逗号分割，例如：ids=1,2,3

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiDelete&model_name=article&ids=36,37&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": ""
    },
    "msg": "小白开放接口：App.SuperTable.MultiDelete"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功删除；1开发类错误，删除失败(表单不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1712 获取总数接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Count

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Count

接口描述： 查 获取直连数据库表中数据的总条目数量

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.Count&model_name=article&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 2
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型数据的总条目数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1713 分组聚合接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeAF

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeAF

接口描述： 查 可以根据自定义的多个条件（AND或者OR），进行GROUP聚合操作运算

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
op_fun枚举类型必须SUM范围：SUM/COUNT/MIN/MAX/AVG聚合函数操作
op_field字符串必须进行聚合的字段名称，例如：SUM(price)中的price价格字段
group_filed字符串用,分割必须分组字段，多个分组字段使用英文逗号分割，相当于：GROUP BY {group_filed}
sort_type整型可选1排序的类型：1是聚合结果升序（默认）；2是聚合结果逆序；3是分组字段升序；4是分组字段降序
page整型可选1最小：1第几页
top_num整型可选10最小：1；最大：500返回结果的数量，前面多少条
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
select_more字符串用,分割可选需要选择的更多字段，默认已经固定返回{groupField}参数字段和聚合结果这两个字段。多个字段用英文逗号分割，如：select_more=id,uuid。如果需要再进行聚合运算，可以类似这样：select_more=id@MIN,uuid。即：字段@聚合运算。聚合运算主要有：SUM/COUNT/MIN/MAX/AVG。id@MIN 对应返回的字段名是 id_AT_MIN，name@COUNT 对应返回字段是 name_AT_COUNT，依次类似。即对应字段格式是：字段_AT_聚合运算。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeAF&model_name=article&op_fun=SUM&op_field=view_times&group_filed=title&where=[["id",">",0]]&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeAF&model_name=article&op_fun=SUM&op_field=view_times&group_filed=title&where_id=GT-0&database=super&app_key={你的app_key}&sign={动态签名}

上面查询相当于，SELECT title, SUM(view_times) AS total_num FROM article WHERE id > 0 GROUP BY title ORDER BY total_num ASC LIMIT 0,10

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "items": [
            {
                "title": "这是一篇文章标题",
                "total_num": "100"
            },
            {
                "title": "这又是另一篇文章标题",
                "total_num": "200"
            },
            // 略……
        ]
    },
    "msg": ""
}


示例2-附加更多选择字段select_more：
请求：
{你的接口域名}/?s=App.SuperTable.FreeAF&model_name=article&op_fun=SUM&op_field=view_times&group_filed=title&where=[["id",">",0]]&select_more=post_time,state@COUNT&database=super&app_key={你的app_key}&sign={动态签名}

上面查询相当于：SELECT post_time, COUNT(state) AS state_AT_COUNT, title, SUM(view_times) AS total_num FROM pa_article_tbl WHERE AND (id > 0) GROUP BY title ORDER BY total_num ASC LIMIT 0,10

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "items": [
            {
                "post_time": "1970-01-01 00:00:00",  // 对应参数：select_more=post_time
                "state_AT_COUNT": "1", // 对应参数：select_more=state@COUNT
                "title": "这是一篇文章标题",
                "total_num": "100"
            },
            {
                "post_time": "1970-01-01 00:00:00",
                "state_AT_COUNT": "1",
                "title": "这又是另一篇文章标题",
                "total_num": "200"
            },
            // 略……
        ]
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.items字符串聚合运算的结果
data.items[].XXX字符串分组字段，由客户端传入的字段而定
data.items[].total_num字符串聚合运算的结果（固定为：total_num）
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1714 自由获取总数接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeCount

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeCount

接口描述： 查 可以根据自定义的多个条件（AND或者OR），获取总数

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
count_by字符串可选需要非重复计数的字段，默认统计全部行数，若传字段则按些字段的非重复数据进行统计，相当于：COUNT(DISTINCT {count_by})。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 3
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型数据的总条目数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1715 分页查询列表数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeQuery

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeQuery

接口描述： 查 分页获取列表数据或全部数据，支持字段选择、排序、条件查询，功能强大，是最为常用的数据接口。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
select字符串用,分割可选SQL语句的SELECT部分，多个字段用英文逗号分割，如：select=id,uuid
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
order字符串JSON格式可选[]SQL语句的ORDER部分，JSON格式。具体格式为：[第一组排序，第二组排序，……]，可以单个或组合排序。
每一组排序格式为："字段名 + 空格 + ASC|DESC"，其中：
  • ASC：为指定列按升序排列
  • DESC：为指定列按降序排列。
例1：单个排序，order=["id DESC"]，表示按ID降序，即最新的在最前面。
例2：组合排序，order=["id DESC", "add_time ASC"]，表示id DESC, add_time ASC，即先按ID从大到小，再按创建时间倒序排序。
特别地，RAND表示随机排序，请慎用。
page整型可选1最小：1第几页
perpage整型可选10最小：1；最大：10000分页数量
is_real_total布尔型可选true是否需要真正的总数，1是0否，当表单数据过多时，如果不需要查询真正的总数，将能极大提升接口响应的速度。若为假总数，固定返回9999999。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeQuery&model_name=article&select=id,title,view_times&where=[["id", ">", "36"]]&order=["view_times DESC"]

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeQuery&model_name=article&select=id,title,view_times&where_id=GT-36&order=["view_times DESC"]

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 2,
        "list": [
        {
            "id": 37,
            "title": "小白开放平台更新公告",
            "view_times": 300
        },
        {
            "id": 38,
            "title": "新接口上线通知",
            "view_times": 260
        }
        ],
            "page": 1,
            "perpage": 10
    },
    "msg": "小白开放接口：App.SuperTable.FreeQuery"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，查询失败(表单不存在或查询错误)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型数据的总条目数量
data.list字符串查询的结果列表数据
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1716 全量数据导出TXT或CSV接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeExport

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeExport

接口描述： 查 可以根据自定义的多个条件（AND或者OR），进行数据导出。成功导出时，此接口会直接生成可供下载的txt或csv文件。个人免费版最多导出5000条，VIP版最多可导出1万条，SVIP版最多可导出2万条。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
select字符串用,分割可选SQL语句的SELECT部分，多个字段用英文逗号分割，如：select=id,uuid
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
order字符串JSON格式可选[]SQL语句的ORDER部分，JSON格式。具体格式为：[第一组排序，第二组排序，……]，如：order = ["id DESC", "add_time ASC"]，表示 id DESC, add_time ASC。特别地，RAND表示随机排序，请慎用。
file_type枚举类型可选txt范围：csv/txt/excel下载文件的类型，txt或csv或excel。
sep字符串可选,数据分割符，@TAB则表示水平制表符。
encoding枚举类型可选UTF-8范围：UTF-8/GB2312导出的CSV/TXT/Excel文件编码，如果需要ANSI格式可使用encoding=GB2312。
page整型可选1最小：1第几页
perpage整型可选1000最小：0；最大：150000分页数量

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，查询失败(表单不存在或查询错误)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1717 精确更改数值接口(可加可减)[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/ChangeNumber

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.ChangeNumber

接口描述： 改 根据ID，修改某个字段的数值，可增加或可减少。通过在服务端进行数值的叠加，尽量保持并发下的数据一致性。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
id整型必须最小：1数据ID
change_field字符串必须待修改数值的字段名
change_value字符串必须待叠加的数值，正数表示相加，负数表示相减，需要传递有效数值

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.ChangeNumber&model_name=article&id=8&change_field=view_times&change_value=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "change_value": "1",
        "after_value": "5"
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；3数据不存在或已被删除
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.change_value字符串回传客户端本次待更改的数值
data.after_value字符串本次更新后，最新的字段值
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1718 自由更改数值接口(可加可减)[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeChangeNumber

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeChangeNumber

接口描述： 改 可以根据自定义的多个条件（AND或者OR），修改某个字段的数值，可增加或可减少。通过在服务端进行数值的叠加，尽量保持并发下的数据一致性。注意，此接口可更新多条数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
change_field字符串用,分割必须待修改数值的字段名，多个字段名用英文逗号分割。change_value和change_field分割后的数量应当相同。
change_value字符串用,分割必须待叠加的数值，正数表示相加，负数表示相减，需要传递有效数值。多个数值用英文逗号分割。change_value和change_field分割后的数量应当相同。
try_add_data字符串JSON格式可选当无更新时尝试创建的数据，仅当无更新且有传此参数时才会进行数据创建。此参数可用于初始化等操作。此参数只用于初始化，不会再进行change_value的修改。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.FreeChangeNumber&model_name=article&where=[["id","=",8]]&change_field=view_times&change_value=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "change_value": "1",
        "update_rows": 1
    },
    "msg": ""
}

如果想希望在更新失败时进行数据创建，可以使用try_add_data参数，从而减少多一次接口请求，以完成数据初始化操作。登录，请求：
{你的接口域名}/?s=App.SuperTable.FreeChangeNumber&model_name=article&logic=and&where=[["id", "=", "404"]]&change_field=view_times&change_value=2&try_add_data={"view_times":1}&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "change_value": "1",
        "update_rows": 1
    },
    "msg": "V1.3.16 小白开放接口 App.SuperTable.FreeChangeNumber"
}
这里接口结果返回的change_value对应本次try_add_data里面的初始化值。

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.change_value字符串回传客户端本次待更改的数值
data.update_rows字符串本次更新的条数，没有更新时为0
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1719 自由获取一条数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeFindOne

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeFindOne

接口描述： 查 可以根据自定义的多个条件（AND或者OR），查找获取一条数据

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
fields字符串用,分割可选需要返回的字段名，多个字段用英文逗号分割，示例：fields=id,uuid,add_time

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeFindOne&model_name=article&where=[["title","=","123456"]]&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeFindOne&model_name=article&where_title=123456&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "id": "5",
            "uuid": "",
            "add_time": "2018-06-27 22:13:28",
            "update_time": null,
            "ext_data": null,
            "title": "123456",
            "content": null,
            "post_time": "1970-01-01 00:00:00",
            "view_times": "0"
        }
    },
    "msg": "",
    "info": [
        "当前请求接口：App.SuperTable.FreeFindOne",
        "小白入门教程：a.okayapi.com/Aa5PH4"
    ]
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取的数据，可以指定返回字段
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1720 加减后返回数据[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetDataAfterChangeNum

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetDataAfterChangeNum

接口描述： 查改 可以根据自定义的多个条件（AND或者OR），查找获取一条数据，然后对指定的字段进行加减操作，最后返回最新的数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
fields字符串用,分割可选需要返回的字段名，多个字段用英文逗号分割，示例：fields=id,uuid,add_time
order字符串可选id ASC排序规则，格式：字段名+空格+ASC|DESC，特别地，RAND表示随机排序。
change_field字符串必须待加减的字段名
change_value字符串必须待加减的数字，正数表示相加，负数表示相减，需要传递有效数值。例如：change_value=1

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.GetDataAfterChangeNum&model_name=article&logic=and&where=[["id", ">", "1"]]&fields=add_time&order=id asc&change_field=view_times&change_value=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "view_times": 204,
            "add_time": "2019-04-06 17:25:13"
        },
        "total": 23
    },
    "msg": "V2.1.0 果创云开放接口 App.SuperTable.GetDataAfterChangeNum"
}

以上会把article文章表单的某一篇文章的阅读数view_times加1，然后返回最新的数据。

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象返回加减后的数据，没有数据时返回null；修改成功时固定会返回修改的字段更新后的最新值
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1721 随机获取一条数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeRandOne

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeRandOne

接口描述： 查 可以根据自定义的多个条件（AND或者OR），随机获取一条数据。获取数据后不会修改或删除数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id",">",0]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
fields字符串用,分割可选需要返回的字段名，多个字段用英文逗号分割，示例：fields=id,uuid,add_time

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取的数据，可以指定返回字段
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1722 “阅后即焚”接口(专取非重复数据)[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreePopOne

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreePopOne

接口描述： 查改 可以根据自定义的多个条件（AND或者OR），查找获取一条数据，并且在获取数据后更改字段，从而实现非重复数据的获取

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
fields字符串用,分割可选需要返回的字段名，多个字段用英文逗号分割，示例：fields=id,uuid,add_time
data字符串JSON格式可选待更新的数据（注意！获取到数据后将会进行此更新），需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）
order_type整型可选1排序类型，默认order_type=1，表示按默认的顺序，即ID升序；order_type=2时表示ID降序；order_type=3表示随机排序，将能更好地实现高并发下的非重复获取（为保证接口质量，随机排序取的数据量超过10W，请联系小白客服进行定制化！）；order_type=4表示更新时间update_time升序；order_type=5表示更新时间update_time降序；

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreePopOne&model_name=article&where=[["state", "=", 0]]&data={"state":1}&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreePopOne&model_name=article&where_state=0&data_state=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "id": "2",
            "uuid": "",
            "add_time": "2018-04-09 23:42:25",
            "update_time": ,
            "ext_data": ,
            "title": "xx",
            "content": "yy",
            "post_time": "1970-01-01 00:00:00",
            "view_times": "2",
            "state": "0"
        }
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取的数据，可以指定返回字段
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1723 即用即删接口(专取非重复数据)[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/DropOneByOne

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.DropOneByOne

接口描述： 查删 根据主键id从小到大依次获取数据，取完就立即删除，从而实现非重复数据的获取。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.DropOneByOne&model_name=article&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "id": "1",
            "uuid": "",
            "title": "小接口做大事情！",
            "add_time": "2019-01-26 18:04:30"
        }
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据；4并发太大，请稍候重试！
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取到的非重复数据，即整条纪录数据。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1724 自由获取最小值接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeMin

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeMin

接口描述： 查 可以根据自定义的多个条件（AND或者OR），获取某个字段的最小值

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
field字符串必须取哪个字段的最小值，如：field=id

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeMin&model_name=article&where=[["id", "<", 3]]&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeMin&model_name=article&where_id=LT-3&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "min": "2"
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.min字符串获取的最小值
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1725 自由获取最大值接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeMax

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeMax

接口描述： 查 可以根据自定义的多个条件（AND或者OR），获取某个字段的最大值

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
field字符串必须取哪个字段的最大值，如：field=id

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.FreeMax&model_name=article&where=[["id", "<", 3]]&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "max": "5"
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.min字符串获取的最大值
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1726 自由求和接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeSum

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeSum

接口描述： 查 可以根据自定义的多个条件（AND或者OR），计算某个字段的总和

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
field字符串必须取哪个字段的总和，如：field=money

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeSum&model_name=article&logic=or&where=[["id","=",1],["id","=",5]]&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeSum&model_name=article&logic=or&where_id=1||5&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "sum": "5"
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.sum字符串总和
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1727 自由删除数据接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeDelete

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeDelete

接口描述： 删 可以根据自定义的多个条件（AND或者OR），删除多条数据。数据一旦删除，无法恢复，请谨慎操作！

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
max_delete_num整型可选0最小：0最多删除多少条，0表示无限制，即全部删除

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeDelete&model_name=article&where=[["id","=",4]]&max_delete_num=1&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeDelete&model_name=article&where_id=4&max_delete_num=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "delete_total": 0
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，删除失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.delete_total整型删除的条目数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1728 批量四则运算接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeMultiCal

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeMultiCal

接口描述： 改 根据条件，批量进行四则运算，即：加/减/乘/除。例如，field=x，op=add，number=1，组合起来表示：x=x+1。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
field字符串必须待更新的字段，如：field=money，此字段必须为数值类型
op枚举类型必须范围：add/sub/mul/div运算符号，加：add，减：sub，乘：mul，乘：div
number字符串必须待运算的数字，例如加多少，减多少，乘多少，除多少。必须为合法的数字，可以是小数

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.FreeMultiCal&model_name=article&where=[["id","=","1"]]&field=view_times&op=add&number=1&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "update_rows": 1
    },
    "msg": ""
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，删除失败(表单不存在)；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.update_rows字符串本次更新的条数，没有更新时为0
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1730 查看表结构[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Desc

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Desc

接口描述： 查 利用DESC命令查看某个表的结构

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.Desc&model_name=okayapi&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "desc": [
            {
                "Field": "id",
                "Type": "int(11)",
                "Null": "NO",
                "Key": "PRI",
                "Default": ,
                "Extra": "auto_increment",
                "Collation": "",
                "Comment": "注释"
            },
            {
                "Field": "OKAYAPI",
                "Type": "varchar(1024)",
                "Null": "YES",
                "Key": "",
                "Default": ,
                "Extra": "",
                "Collation": "",
                "Comment": "注释"
            }
        ]
    },
    "msg": "当前请求接口：App.SuperTable.Desc"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.desc字符串表结构描述
data.desc[].Field字符串字段名称
data.desc[].Type字符串字段类型，例如：int(11)
data.desc[].Collation字符串字段编码，例如：utf8mb4_general_ci
data.desc[].Null字符串是否允许为空，YES/NO
data.desc[].Key字符串字段索引，空/PRI/NOR
data.desc[].Default字符串默认值
data.desc[].Extra字符串额外信息，例如：auto_increment
data.desc[].Comment字符串字段注释
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1731 万能变更接口[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/ICanDoIt

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.ICanDoIt

接口描述： 改 可以执行原始的SQL语句进行数据库变更，例如建表、加字段、加索引、改字段等。你可以通过配置小白直连数据库账号的权限来控制允许进行哪些变更。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须此时的表名可任意指定一个
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
sql字符串必须待执行的任意SQL语句，须符合MySQL数据库语法，请谨慎操作

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（注意sql参数的语法、编码和特殊字符，推荐用POST方式）：
{你的接口域名}/?s=App.SuperTable.ICanDoIt&model_name=OKAYAPI&database=super&sql=ALTER TABLE okayapi ADD COLUMN test_name VARCHAR(10)&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "sql": "ALTER TABLE okayapi ADD COLUMN test_name5 VARCHAR(10)"
    },
    "msg": "当前请求接口：App.SuperTable.ICanDoIt"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.sql字符串返回本次成功执行SQL语句
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1732 通过原始SQL查库[直连版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/SqlQuery

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.SqlQuery

接口描述： 查 可以通过原始SQL语句，查询数据库，并返回全部结果集。你可以通过配置小白直连数据库账号的权限来控制允许查询哪些表。注意查询的结果不要过大，以免卡死！

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须此时的表名可任意指定一个
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
sql字符串必须待查询的完整SQL语句，须符合MySQL数据库语法，只支持SELECT系列的操作。推荐此参数使用POST方式，若使用GET方式须进行URL编码，以免解析出错

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（注意查询的结果不要过大，以免卡死！）：
{你的接口域名}/?s=App.SuperTable.SqlQuery&model_name=okayapi&sql=select id,username,time from okayapi_test limit 0, 3&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "sql": [
            {
                "id": "1",
                "username": "dogstar1",
                "time": "2018-04-09 20:40:20"
            },
            {
                "id": "2",
                "username": "dogstar2",
                "time": "2018-04-09 20:40:20"
            },
            {
                "id": "3",
                "username": "dogstar3",
                "time": "2018-04-09 20:40:20"
            }
        ]
    },
    "msg": "当前请求接口：App.SuperTable.SqlQuery"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.sql字符串返回本次成功查询的结果
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1803 批量创建非重复新数据接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiCheckCreate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiCheckCreate

接口描述： 批量增非重复 批量操作，在自定义数据表单中添加一个【非重复】新数据，添加的字段应先在小白开放平台进行添加。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
datas字符串JSON格式必须批量创建时的初始化数据，注意是数组格式，需要JSON编码后传递。格式：datas=[{"字段名1":"字段值1","字段名2":"字段值2"...}]。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证
check_field字符串用,分割必须待检测的字段。注意：data数据中必须包含此字段的数据，用作检测重复的依据。多个检测字段用英文逗号分割。例如：check_field=name,age，表示同时检测名字和年龄。请留意字段类型的相等性判断，如字符串类型的字段不能在data参数中传整型参数。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiCheckCreate&model_name=article&datas=[{"title":"aaa"},{"title":"bbb"},{"title":"ccc"}]&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "details": [
        {
            "id": 1,
            "msg": "创建成功",
            "data_id": 42,
            "create_status": 0
        },
        {
            "id": 2,
            "msg": "创建成功",
            "data_id": 43,
            "create_status": 0
        },
        {
            "id": 3,
            "msg": "创建成功",
            "data_id": 44,
            "create_status": 0
        }
        ]
    },
    "msg": "V1.3.4 小白开放接口 App.SuperTable.MultiCheckCreate"
}


再次请求：
{你的接口域名}/?s=App.SuperTable.MultiCheckCreate&model_name=article&datas=[{"title":"aaa"},{"title":"123"},{"title":"456"}]&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "details": [
        {
            "id": 1,
            "msg": "数据已存在，不再创建",
            "data_id": 42,
            "create_status": 2
        },
        {
            "id": 2,
            "msg": "创建成功",
            "data_id": 45,
            "create_status": 0
        },
        {
            "id": 3,
            "msg": "创建成功",
            "data_id": 46,
            "create_status": 0
        }
        ]
    },
    "msg": "V1.3.4 小白开放接口 App.SuperTable.MultiCheckCreate"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1操作失败，2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.details字符串创建的详情
data.details[].id整型客户端传递参数的序号，从1开始
data.details[].create_status整型服务端创建非重复数据的状态，0表示创建添加成功，1表示创建失败，2表示数据已存在
data.details[].data_id整型数据ID，创建成功时是新添加数据的ID，数据存在时是原来数据的ID
data.details[].msg字符串创建时的错误提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1804 创建或更新非重复新数据接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/CheckCreateOrUpdate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.CheckCreateOrUpdate

接口描述： 增改非重复 在自定义数据表单中尝试添加一个【非重复】新数据，如果数据已经存在，则进行更新操作。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
data字符串JSON格式可选创建时的初始化数据，需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）
check_field字符串用,分割必须待检测的字段。注意：data数据中必须包含待检测的全部字段。即check_field可指定data数据中的一个或多个字段。多个检测字段用英文逗号分割。例如：check_field=name,age，表示同时检测名字和年龄。请留意字段类型的相等性判断，如字符串类型的字段不能在data参数中传整型参数。
logic枚举类型可选and范围：and/or多个check_field的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（使用data的JSON格式传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.CheckCreateOrUpdate&model_name=article&data={"title":"abc"}&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

请求（使用data_X动态参数传递，data和data_X二选一）：
{你的接口域名}/?s=App.SuperTable.CheckCreateOrUpdate&model_name=article&data_title=abc&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

返回（如果未存在就新建）：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "id": 4,
        "op_type": "insert"
    },
    "msg": ""
}


如果数据已经存在，则返回（存在则更新）：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "id": 4,
        "op_type": "update"
    },
    "msg": ""
}

以下示例演示了多个检测字段使用逻辑或的效果，请求：
{你的接口域名}/?s=App.SuperTable.CheckCreateOrUpdate&model_name=article&data={"title":"abc","view_times":1}&check_field=title,view_times&logic=or

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "id": 52,
        "op_type": "update"
    },
    "msg": "V1.4.2 小白开放接口 App.SuperTable.CheckCreateOrUpdate"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1创建失败(不符合表字段要求，或表字段不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.id整型新创建数据的自增ID/或原来数据的ID
data.op_type字符串本次操作的具体类型，insert为插入，update为更新
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1805 批量创建或更新非重复新数据接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiCheckCreateOrUpdate

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiCheckCreateOrUpdate

接口描述： 批量增改非重复 批量版接口，在自定义数据表单中尝试添加一个【非重复】新数据，如果数据已经存在，则进行更新操作。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
datas字符串JSON格式必须需要批量创建的初始化数据，需要JSON编码后传递。格式：datas=[{第一组数据},{第二组数据},{第三组数据……}]。每一组的数据格式：{"字段名1":"字段值1","字段名2":"字段值2"...}。数据中的uuid将优先于model_uuid参数。JSON在线解析及格式化验证
check_field字符串用,分割必须待检测的字段，非批量，全部检测的字段都应一致。注意：datas批量数据每一组数据中必须包含待检测的全部字段。即check_field可指定data数据中的一个或多个字段。多个检测字段用英文逗号分割。例如：check_field=name,age，表示同时检测名字和年龄。请留意字段类型的相等性判断，如字符串类型的字段不能在data参数中传整型参数。
logic枚举类型可选and范围：and/or多个check_field的逻辑组合，非批量，全部检测的字段都应一致。logic=and表示逻辑且，logic=or表示逻辑或

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiCheckCreateOrUpdate&model_name=article&datas=[{"title":"aaa","state":1},{"title":"bbb","state":0}]&check_field=title&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "details": [
        {
            "op_type": "update",
            "id": 42
        },
        {
            "op_type": "update",
            "id": 43
        }
        ]
    },
    "msg": "V1.3.20 小白开放接口 App.SuperTable.MultiCheckCreateOrUpdate"
}

以下是部分参数格式错误的请求示例：
{你的接口域名}/?s=App.SuperTable.MultiCheckCreateOrUpdate&model_name=article&datas=[{"title":"aaa","state":1,"content":"文章内容"},{"title":"bbb"}]&check_field=title,state

返回：
{
    "ret": 200,
    "data": {
        "err_code": 3,
        "err_msg": "data参数中，缺少需要检测重复的state字段数据。",
        "details": [
        {
            "op_type": "insert",
            "id": "57"
        },
        {
            "op_type": "fail",
            "id": 0,
            "error": "data参数中，缺少需要检测重复的state字段数据",
            "data": {
                "title": "bbb"
            }
        }
        ]
    },
    "msg": "V1.3.22 小白开放接口 App.SuperTable.MultiCheckCreateOrUpdate"
}

以下示例演示在批量中使用逻辑或的效果，请求：
{你的接口域名}/?s=App.SuperTable.MultiCheckCreateOrUpdate&model_name=article&datas=[{"title":"aaa","state":1,"content":"文章内容"},{"title":"bbb","state":0}]&check_field=title,state&logic=or

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "details": [
        {
            "op_type": "update",
            "id": 42
        },
        {
            "op_type": "update",
            "id": 36
        }
        ]
    },
    "msg": "V1.4.2 小白开放接口 App.SuperTable.MultiCheckCreateOrUpdate"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1创建失败(不符合表字段要求，或表字段不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；3存在部分失败的情况
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.details字符串批量的结果
data.details[].id整型新创建数据的自增ID/或原来数据的ID
data.details[].op_type字符串本次操作的具体类型，insert为插入，update为更新，fail为失败（参数错误）
data.model_name字符串当前表单名称
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1808 批量极速创建新数据接口[二分法递归增强版]

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiFastCreateExt

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiFastCreateExt

接口描述： 批量增 批量极速导入多条新数据[二分法递归增强版]，此接口的区别在于，若批量创建的数据失败，则会进行对半拆分分别重试创建，从而最大可能导入数据，最大重试深度为4级。其他功能请参见：批量极速创建新数据接口。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
datas字符串JSON格式必须批量导入的数据。特别注意！这是复数datas，即需要传递是的单个创建时的数组的数组。格式为JSON，即：datas=[单个创建时的数据1, 单个创建时的数据2, ...]。一次最多只允许导入1000条数据。若批量创建的数据失败，则会进行对半拆分分别重试创建，从而最大可能导入数据，最大重试深度为4级。
is_ignore布尔型可选true是否启用IGNORE，1是0否，其中：
  • 若为是，则在创建时判断是否存在相同的数据，并且重复时忽略跳过，最终结果是部分或全部成功创建；
  • 若为若，则不管是否存均进行创建，如果有唯一索引或其他原因导致失败将会全部创建不成功。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
以下示例将会演示小白接口如何进行二分法递归创建。对于文章表单：article，需要创建以下三组数据：
title1=aaa（注：字段名错误）
title=bbb
title2=ccc（注：字段名错误）

请求：
{你的接口域名}/?s=App.SuperTable.MultiFastCreateExt&model_name=article&datas=[{"title1":"aaa"},{"title":"bbb"},{"title2":"ccc"}]&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 1
    },
    "msg": "V1.3.12 小白开放接口 App.SuperTable.MultiFastCreateExt"
}

从接口结果可以看到成功创建1组数据，而不是全部失败。

背后的二分法递归创建流程是：

+ 第1次，全部批量创建{"title1":"aaa"},{"title":"bbb"},{"title2":"ccc"}，但失败（title1和title2字段非法）。
    + 第2次，批量创建{"title1":"aaa"},{"title":"bbb"}，但失败（title1字段非法）。
        + 第3次，批量创建{"title1":"aaa"}，但失败（title1字段非法）。
        + 第4次，批量创建{"title":"bbb"}，成功。
    + 第5次，批量创建{"title2":"ccc"}，但失败（title2字段非法）。

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0导入成功；1导入失败(如表不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型本次导入的总数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1813 生成并下载word文档

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetDocx

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetDocx

接口描述： 查 根据ID，获取自定义数据表单中的数据，并生成可直接下载的word文档。HTML内容将会被作为普通文本序列化输出。注意，仅当成功时才可下载word文档，失败时依然以接口JSON结果返回。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
id整型必须最小：1数据ID，例如：1，2，3，……
title字符串可选word文档标题及文件名
tpl字符串可选word文档的模板，表单字段点位符为：{{字段名}}。例如：
ID为{{id}}，更新时间为{{update_time}}，创建时间{{add_time}}，特别地，换行为{{\n}}。
未设置模板时，默认显示全部字段，一行一个字段
font_style字符串JSON格式可选{"name":"Arial"}word文档的格式设置，JSON格式，示例：
{"name": "Microsoft Yahei UI", "size": 20, "color": "#ff6600", "bold": true}
格式配置：
  • name：字体，如微软雅黑为Microsoft Yahei UI，又如Arial
  • size：字体大小，例如14、20、22
  • color：字体颜色，如黑色为#000000
  • bgColor：字体背景色，例如#FF0000
  • bold：是否为粗体，布尔值
  • italic：是否为斜体，布尔值

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功，注意，仅当成功时才可下载word文档，失败时依然以接口JSON结果返回。；1开发类错误，获取失败(符合表字段要求，或表字段不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；3获取失败(数据已删除或不存在)
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1823 关联查询列表数据接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeLeftJoinQuery

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeLeftJoinQuery

接口描述： 查关联 有一定复杂度，但可实现功能强大的关联查询，以便实现同时获取两个表单的数据。根据自定义的多个条件（AND或者OR），进行搜索和查询，支持左关联查询，目前只支持关联一个表查询。可以通过文档示例增强对引接口的理解和使用，如有问题，请及时咨询技术客服。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
join_model_name字符串必须需要关联的表单名称，目前只支持关联一个表
select字符串用,分割可选针对主表的SQL语句的SELECT部分，多个字段用英文逗号分割，如：select=id,uuid。
join_select字符串用,分割必须最小：1针对关联表的SQL语句的SELECT部分，至少需要指定获取一个字段，多个字段用英文逗号分割，如：select=id,uuid。注意：为避免字段名称冲突，关联表字段在接口返回的结果中的名称为：{关联表单名称}_{关联字段名称}。
on字符串JSON格式必须[]用于指定表单关联关系的ON部分，JSON格式，key-value对，key为主表字段名，value为关联表字段名，支持多组。例如：model_name.name = join_model_name.name AND model_name.age = join_model_name.other_age，则接口传递参数为：on={"name":"name","age":"other_age"}
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
order字符串JSON格式可选[]针对主表的SQL语句的ORDER部分，JSON格式。具体格式为：[第一组排序，第二组排序，……]，可以单个或组合排序。
每一组排序格式为："字段名 + 空格 + ASC|DESC"，其中：
  • ASC：为指定列按升序排列
  • DESC：为指定列按降序排列。
例1：单个排序，order=["id DESC"]，表示按ID降序，即最新的在最前面。
例2：组合排序，order=["id DESC", "add_time ASC"]，表示id DESC, add_time ASC，即先按ID从大到小，再按创建时间倒序排序。
特别地，RAND表示随机排序，请慎用。
page整型可选1最小：1第几页
perpage整型可选10最小：1；最大：10000分页数量
is_real_total布尔型可选true是否需要真正的总数，1是0否，当表单数据过多时，如果不需要查询真正的总数，将能极大提升接口响应的速度。若为假总数，固定返回9999999。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
假设，当前有两个表单，分别是：文章内容表单（article）、文章分类表单（category），其中：

文章内容表单（article）数据如下：
+----+----------------------+----------------------------------------------------------------+------------+---------+
| id | title                | content                                                        | view_times | cate_id |
+----+----------------------+----------------------------------------------------------------+------------+---------+
| 36 | PHP程序员历险记223   | <p>PHP（中文名：“超文本预处理器”）是一种通用开源脚本语言。</p> |        200 |       3 |
| 37 | 小白开放平台更新公告 | <p>1.推出四大优惠券 2.新增#修改会员分组#接口</p>               |        300 |       1 |
| 38 | 我改了标题           | <p>创建或更新非重复新数据接口</p>                              |        260 |       2 |
| 39 | 标签                 | <p>我爱你，中国</p>                                            |        100 |       0 |
+----+----------------------+----------------------------------------------------------------+------------+---------+
4 rows in set

文章分类表单（category）数据如下：
+----+-----------+---------+
| id | cate_name | is_show |
+----+-----------+---------+
|  1 | 大数据    |       0 |
|  2 | 人工智能  |       1 |
|  3 | 编程开发  |       1 |
+----+-----------+---------+
3 rows in set

并且，article.cate_id字段表示分类ID。那么，下面将演示如何进行关联查询。

【关联查询示例1】查询文章内容id = 36的文章信息以及关联的分类信息。

请求：
{你的接口域名}/?s=App.SuperTable.FreeLeftJoinQuery&model_name=article&join_model_name=category&select=id,title,content,view_times,cate_id&join_select=cate_name&on={"cate_id":"id"}&logic=and&where=[["id", "=", "36"]]&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 1,
        "list": [
        {
            "id": 36,
            "title": "PHP程序员历险记223",
            "content": "<p>PHP（中文名：“超文本预处理器”）是一种通用开源脚本语言。</p>",
            "view_times": 200,
            "cate_id": 3,
            "category_cate_name": "编程开发"
        }
        ],
            "page": 1,
            "perpage": 10
    },
    "msg": "V1.2.28 小白开放接口 App.SuperTable.FreeLeftJoinQuery"
}

【关联查询示例2】查询访问量大于等于100且分类为显示的文章数据。
需要注意，where参数的三元组写法（如上面示例1）默认全部作用于主表单。如果需要对关联表单进行条件判断，需要改用MySQL条件字符串。同时约定：主表单别名为TL（表示Table Left）、关联表单别名为TR（表示Table Right）。下面示例将进行演示。

请求：
{你的接口域名}/?s=App.SuperTable.FreeLeftJoinQuery&model_name=article&join_model_name=category&select=id,title,content,view_times,cate_id&join_select=cate_name&on={"cate_id":"id"}&logic=and&where=["TL.view_times >= 100", "TR.is_show = 1"]&page=1&perpage=10&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "total": 2,
        "list": [
        {
            "id": 36,
            "title": "PHP程序员历险记223",
            "content": "<p>PHP（中文名：“超文本预处理器”）是一种通用开源脚本语言。</p>",
            "view_times": 200,
            "cate_id": 3,
            "category_cate_name": "编程开发"
        },
        {
            "id": 38,
            "title": "我改了标题",
            "content": "<p>创建或更新非重复新数据接口</p>",
            "view_times": 260,
            "cate_id": 2,
            "category_cate_name": "人工智能"
        }
        ],
            "page": 1,
            "perpage": 10
    },
    "msg": "V1.2.28 小白开放接口 App.SuperTable.FreeLeftJoinQuery"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，查询失败(表单不存在或查询错误)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.total整型数据的总条目数量
data.list字符串查询的结果列表数据
data.page整型当前第几页
data.perpage整型当前分页数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1826 批量自由更改数值接口(可加可减)

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/MultiFreeChangeNumber

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.MultiFreeChangeNumber

接口描述： 批量 改 可以根据自定义的多个条件（AND或者OR），批量修改某个或多个字段的数值，可增加或可减少。通过在服务端进行数值的叠加，尽量保持并发下的数据一致性。注意，此接口可更新多条数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
wheres字符串JSON格式必须批量条件，格式为：wheres=[第一组,第二组,……]。每一组where参数格式如下： SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
change_field字符串用,分割必须待修改数值的字段名，多个字段名用英文逗号分割。change_value和change_field分割后的数量应当相同。
change_values字符串JSON格式必须批量待叠加的数值，格式是：change_values=["第一组","第二组","……"]。每一组格式为：正数表示相加，负数表示相减，需要传递有效数值。多个数值用英文逗号分割。每一组和change_field分割后的数量应当相同。示例：change_values=["1","2"]，更新多个值时的示例：["1,11","2,22"]
try_add_datas字符串JSON格式可选批量的初始化数据，格式为：try_add_datas=[第一组，第二组，……]。当无更新时尝试创建的数据，仅当无更新且有传此参数时才会进行数据创建。此参数可用于初始化等操作。try_add_datas要么不传，要么需要和change_values的数量保持一致，对于不需要初始化的可以设置为NULL。此参数只用于初始化，不会再进行change_value的修改。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.MultiFreeChangeNumber&model_name=article&logic=and&wheres=[[["id", "=", "404"]],[["id", "=", "405"]]]&change_field=view_times&change_values=["2","3"]&try_add_datas=[{"view_times":"1"},{"view_times":"3"}]&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "details": [
        {
            "err_code": 0,
            "err_msg": "",
            "change_value": "2",
            "update_rows": 1
        },
        {
            "err_code": 0,
            "err_msg": "",
            "change_value": "3",
            "update_rows": 1
        }
        ]
    },
    "msg": "V1.3.22 小白开放接口 App.SuperTable.MultiFreeChangeNumber"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；2应用层规则拦截，拦截后可以小白开放平台查看日记，3表示部分失败，具体查看details批量结果
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.details字符串批量结果
data.details[].change_value字符串回传客户端本次待更改的数值
data.details[].update_rows整型每组数据的更新结果，对应更新的条目数量。没有更新或没有创建时为0，如果进行更新或初始化创建则为1，其他情况为对应更新的条目数量
data.details[].err_code整型单次操作的操作码，当err_code为0时才表示正确执行，最终更新结果再看update_rows的返回
data.details[].err_msg字符串单次操作的错误提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1827 自由批量拼接字符串(可前可后)

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeConcact

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeConcact

接口描述： 改 可以根据自定义的多个条件（AND或者OR），修改某个字段的字符串内容，可以在前面追加拼接，也可以拼接在后面。同时支持分割符。通过在服务端进行字符串的叠加，尽量保持并发下的数据一致性。注意，此接口可更新多条数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
change_field字符串必须待修改字符串的字段名，如果不希望在前后出现多余的分割符，可将字段的默认值设置为NULL。
concact_str字符串必须待追加的字符串
seperator字符串可选分割符，默认为空字符串
side枚举类型可选right范围：right/left新增的追加在哪边，其中：
  • right表示右边，即后面；
  • left表示左边，即前面。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeConcact&model_name=article&where=[["id", "=", 41]]&change_field=tag&concact_str=接口&seperator=,&side=right&database=super&app_key={你的app_key}&sign={动态签名}

请求（where和where_X二选一）：
{你的接口域名}/?s=App.SuperTable.FreeConcact&model_name=article&where_id=41&change_field=tag&concact_str=接口&seperator=,&side=right&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "update_rows": 1
    },
    "msg": "小白开放接口：App.SuperTable.FreeConcact"
}

假设id=41的数据，标签字段tag最初的默认值为NULL，那么第一次请求后，tag变成：接口。  

当再次请求时，tag此时原来的内容是：接口。则会变成：接口,接口。中间有分割符逗号。

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.update_rows字符串本次更新的条数，没有更新时为0
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1832 “阅后即焚”接口拓展(专取多条非重复数据)

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreePopAll

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreePopAll

接口描述： 查改非重复 可以根据自定义的多个条件（AND或者OR），查找获取多条数据（取全部或批量多条），并且在获取数据后批量更改字段，从而实现非重复数据的获取

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
fields字符串用,分割可选需要返回的字段名，多个字段用英文逗号分割，示例：fields=id,uuid,add_time
data字符串JSON格式可选待更新的数据（注意！获取到数据后将会进行此更新），需要JSON编码后传递。格式：data={"字段名1":"字段值1","字段名2":"字段值2"...}。JSON在线解析及格式化验证（data和data_X二选一）
data_X字符串可选动态参数，优先于data的JSON数据。可自由传入动态参数，字段名组合格式：data_ + X（X要换成你的字段名），例如数据表单标题title字段，组合后为：&data_title=YesApi，等效于：&data={"title":"YesApi"}。可以同时传入多个动态参数，例如：&data_title=YesApi&data_year=2020，比JSON格式更方便（data和data_X二选一）
order_type整型可选1排序类型，默认order_type=1，表示按默认的顺序，即ID升序；order_type=2时表示ID降序；order_type=3表示随机排序，将能更好地实现高并发下的非重复获取；order_type=4表示更新时间update_time升序；order_type=5表示更新时间update_time降序；
top_num整型可选0最小：0最多返回前面多少条，0表示全部取出

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象获取的数据，可以指定返回字段
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1836 自由聚合运算接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeAggregation

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeAggregation

接口描述： 查统计 可以根据自定义的多个条件（AND或者OR），进行SUM/COUNT/MIN/MAX/AVG等聚合运算，同时支持多个字段的聚合运算。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
op_funs字符串用,分割必须最小：1聚合函数操作，支持多个聚合运算，目前支持：SUM/COUNT/MIN/MAX/AVG，分别表示：求和/数目/最小/最大/平均数，注意全部大写，多个用英文逗号分割。
op_fields字符串用,分割必须进行聚合的字段名称，需要和op_funs的运算一一对应，，多个用英文逗号分割。例如：假设op_funs=SUM,COUNT，同时op_fields=price,id，那么最终相当于：SUM(price), COUNT(id)，返回结果字段是：SUM_price, COUNT_id
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.FreeAggregation&model_name=article&op_funs=COUNT,SUM&op_fields=id,view_times&logic=and&where=[["git_author", "=", "dogstar"]]&database=super&app_key={你的app_key}&sign={动态签名}

返回（计算某位作者共发表多少张文章，以及合计的阅读数量）：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "report": {
            "COUNT_id": 5,
            "SUM_view_times": "760"
        }
    },
    "msg": "小白开放接口：App.SuperTable.FreeAggregation"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，获取失败(表单不存在)；2应用层规则拦截，拦截后可以小白开放平台查看日记；3查无数据
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.report对象聚合运算的表格数据
data.report.SUM_fieldmixed返回的字段是动态的名称，字段名是：聚合运算名+下划线+字段名，例如：SUM_field。失败时返回 NULL，根据运算和字段类型不同，返回结果可能是int，也可能是string类型，或浮点数。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1840 获取单字段的每日统计报表

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetFiledDailyDataReport

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetFiledDailyDataReport

接口描述： 查统计 针对单个字段，获取两个周期内每日的统计报表，可以统计总数或总条目数量，即：sum({field}) 或 count({field})。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
op枚举类型可选COUNT范围：SUM/COUNT需要统计的类型，求和：SUM，算总条目数：COUNT
field字符串必须需要统计的字段，如：field=money
date_field字符串必须add_time需要统计的时间日期字段，此字段类型必须是datetime，如：field=add_time
days整型可选7最大：180多少天前的对比报表数据，例如7表示一周前，30天表示上个月
startDate日期可选开始日期，例如：2020-02-20
endDate日期可选结束日期，例如：2020-02-27，包含结束当天的数据。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.GetFiledDailyDataReport&model_name=article&op=COUNT&field=view_times&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "items": {
            "now": [
            {
                "date": "2019-03-12",
                "total": 0,
                "id": 1
            },
            {
                "date": "2019-03-13",
                "total": 0,
                "id": 2
            },
            {
                "date": "2019-03-14",
                "total": 0,
                "id": 3
            },
            {
                "date": "2019-03-15",
                "total": 0,
                "id": 4
            },
            {
                "date": "2019-03-16",
                "total": 0,
                "id": 5
            },
            {
                "date": "2019-03-17",
                "total": 3,
                "id": 6
            },
            {
                "date": "2019-03-18",
                "total": 0,
                "id": 7
            }
            ],
                "pre": [
                {
                    "date": "2019-03-05",
                    "total": 0,
                    "id": 1
                },
                {
                    "date": "2019-03-06",
                    "total": 0,
                    "id": 2
                },
                {
                    "date": "2019-03-07",
                    "total": 0,
                    "id": 3
                },
                {
                    "date": "2019-03-08",
                    "total": 0,
                    "id": 4
                },
                {
                    "date": "2019-03-09",
                    "total": 0,
                    "id": 5
                },
                {
                    "date": "2019-03-10",
                    "total": 3,
                    "id": 6
                },
                {
                    "date": "2019-03-11",
                    "total": 0,
                    "id": 7
                }
            ]
        }
    },
        "msg": "小白开放接口：App.SuperTable.GetFiledDailyDataReport"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.items对象报表数据
data.items.now字符串最近几天的统计数据
data.items.now[].id整型序号
data.items.now[].date字符串日期，格式如：2019-04-01
data.items.now[].total浮点型统计的总数
data.items.pre字符串上一周期的统计数据
data.items.pre[].id整型序号
data.items.pre[].date字符串日期，格式如：2019-04-01
data.items.pre[].total浮点型统计的总数
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1841 获取树状分类数据接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeTree

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeTree

接口描述： 查 可以根据自定义条件获取树状分类的数据，可用于：组织架构、目录分类、网站菜单、级联地址等场景。要求：表单结构中须含有指向父级的ID。当前最多一次性获取两层。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
parent_field字符串必须parent_id子级存放父级id的字段名称，此字段必须要出现在表单中，为int类型。如果不想使用默认的字段名称parent_field，可以自定义其他字段名称。
parent_id整型必须0所属父类id的值，顶级分类的父级id值为0。固定对应表单中id字段的值。具体使用请见下方请求示例。
where字符串JSON格式可选[]可选且安全的where条件，格式为：[["第一个位置表示字段名称（字段必须先存在）","第二个位置表示判断>符号（可以是：>、>=、<、<=、=、<>, LIKE）","第三个位置表示判断值"]]。多个条件逻辑关系为：AND，并且接口会默认加上父级ID的匹配。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）
select字符串用,分割可选SQL语句的SELECT部分，多个字段用英文逗号分割，如：select=id,uuid
order字符串JSON格式可选[]SQL语句的ORDER部分，格式为：[第一组排序，第二组排序，……]，如：order = ["id DESC", "add_time ASC"]，表示 id DESC, add_time ASC。特别地，RAND表示随机排序。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
假设有表单网站菜单：website_menu

表单数据有：
+----+--------------+-----------+
| id | title        | parent_id |
+----+--------------+-----------+
|  1 | 首页         |         0 |
|  2 | 接口         |         0 |
|  3 | 通用接口     |         2 |
|  4 | 插件接口     |         2 |
|  5 | 文档         |         0 |
|  6 | 接口文档     |         5 |
|  7 | 平台文档     |         5 |
|  8 | 联系我们     |         0 |
+----+--------------+-----------+

请求：
{你的接口域名}/?s=Table.FreeTree&model_name=website_menu&parent_id=0&select=title&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "tree": [
            {
                "title": "首页",
                "id": 1,
                "parent_id": 0,
                "children_tree": []
            },
            {
                "title": "接口",
                "id": 2,
                "parent_id": 0,
                "children_tree": [
                    {
                        "title": "通用接口",
                        "id": 3,
                        "parent_id": 2
                    },
                    {
                        "title": "插件接口",
                        "id": 4,
                        "parent_id": 2
                    }
                ]
            },
            {
                "title": "文档",
                "id": 5,
                "parent_id": 0,
                "children_tree": [
                    {
                        "title": "接口文档",
                        "id": 6,
                        "parent_id": 5
                    },
                    {
                        "title": "平台文档",
                        "id": 7,
                        "parent_id": 5
                    }
                ]
            },
            {
                "title": "联系我们",
                "id": 8,
                "parent_id": 0,
                "children_tree": []
            }
        ]
    },
    "msg": "小白开放接口：App.SuperTable.FreeTree"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，查询失败(表单不存在或查询错误)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.tree字符串树状数据
data.tree[].id整型固定返回，ID
data.tree[].{parent_id}整型固定返回，父级ID，字段名由客户端指定
data.children_tree字符串子节点的树状数据，没有时为空数组。表单中不能添加children_tree字段，以免引起冲突。返回字段、过滤条件和排序逻辑和顶层一样。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1842 点对点同级账号“转账”接口

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/Transfer

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.Transfer

接口描述： 改 在同一个表单内的同一字段，进行点对点同级“转账”操作。例如：把A账号的100积分转到B账号的积分。要求：转出和转入账号纪录已经存在且必须唯一；字段类型和“转账”数量均为整数；符合交换律和零和（即A转给B，然后B再转给A后，恢复和最初的一样）。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
account_field字符串必须最小：1账号字段名称
from_account字符串必须最小：1转出账号，即对应account_field字段的值，必须存在且唯一
to_account字符串必须最小：1转入账号，即对应account_field字段的值，必须存在且唯一
amount_field字符串必须最小：1数量字段名称，此字段必须为整数类型，例如：tinyint、smallint、int、bigint等
amount整型必须最小：1待转的数量，必须为整数，且为正整数，且转出账号数量充足

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
假设有以下表单数据：
+----------+--------+
| username | points |
+----------+--------+
| A        |     10 |
| B        |      5 |
+----------+--------+

现在需要把A账号的3个元宝转移给B账号。那么此时，转出账号为A，转入账号为B，转移的数量为3，账号字段为username，数量字段为points。

请求：
{你的接口域名}/?s==App.SuperTable.Transfer&model_name=points&account_field=username&from_account=A&to_account=B&amount_field=points&amount=3&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "from_account_amout": 7,
        "to_account_amout": 8,
        "amount": 3
    },
    "msg": "小白开放接口：App.SuperTable.Transfer"
}

成功转移后，表单的最新数据是：
+----------+--------+
| username | points |
+----------+--------+
| A        |      7 |
| B        |      8 |
+----------+--------+

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误；2应用层规则拦截，拦截后可以小白开放平台查看日记；10转出账号不存在；11转出账号不唯一；12转出账号数量不足；20转入账号不存在；21转入账号不唯一
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.from_account_amout整型成功转移后转出账号的剩余数量
data.to_account_amout整型成功转移后转入账号的最新数量
data.amount整型成功转移后本次转移的数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1843 根据单字段获取一条数据

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetOneDataByOneField

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetOneDataByOneField

接口描述： 查 根据一个字段快速获取其他字段的数据。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
field_name字符串必须需要匹配的表单字段名称
field_value字符串必须需要查找和对比的字段值
select字符串用,分割可选需要返回的字段，默认返回全部字段，多个字段用英文逗号分割，如：select=id,uuid

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.GetOneDataByOneField&model_name=article&field_name=title&field_value=aaa&select=title,view_times,add_time&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "data": {
            "id": 42,
            "title": "aaa",
            "view_times": 0,
            "add_time": "2019-11-29 15:25:16"
        }
    },
    "msg": "V1.3.22 小白开放接口 App.SuperTable.GetOneDataByOneField"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；2应用层规则拦截，拦截后可以小白开放平台查看日记，3数据不存在或已删除
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.data对象查找到的数据，如果未找到则为null。其中，id字段固定返回。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1844 根据多字段获取多条数据

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetMoreDataByMoreField

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetMoreDataByMoreField

接口描述： 查 根据一个字段或多个字段取一条或多条数据。最多返回20条。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
field_name_list字符串用,分割必须最小：1需要匹配的表单字段名称列表，多个字段用英文逗号分割，如：field_name_list=title,name
field_value_list字符串用,分割必须最小：1需要查找和对比的字段值列表，多个值用英文逗号分割，如：field_value_list=标题,小白。字段值不能含有英文逗号。field_value_list数量必须和field_name_list数量保持一致。
select字符串用,分割可选需要返回的字段，默认返回全部字段，多个字段用英文逗号分割，如：select=id,uuid
page整型可选1最小：1第几页
perpage整型可选20最小：1；最大：10000分页数量

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.GetMoreDataByMoreField&model_name=article&logic=and&field_name_list=title,view_times&field_value_list=aaa,0&select=title,view_times,add_time&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "items": [
        {
            "title": "aaa",
            "view_times": 0,
            "add_time": "2019-11-29 15:25:16"
        },
        {
            "title": "aaa",
            "view_times": 0,
            "add_time": "2019-12-15 22:03:40"
        }
        ]
    },
    "msg": "V1.3.22 小白开放接口 App.SuperTable.GetMoreDataByMoreField"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.items对象查找到的数据列表，如果未找到则为空数组。默认返回20条，ID升序获取。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1845 获取字段下拉列表

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/GetFieldDropdownList

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.GetFieldDropdownList

接口描述： 查 获取指定字段的下拉列表，全表去重后顺序显示。最多显示前面1000条。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
field_name字符串必须字段名称，需要获取下拉列表的字段
num整型可选100最小：2；最大：1000返回的列表数量
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id",">",0]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.SuperTable.GetFieldDropdownList&model_name=article&field_name=tag&database=super&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "items": [
            "",
            "接口",
            "开发"
        ]
    },
    "msg": "V1.4.9 小白开放接口 App.SuperTable.GetFieldDropdownList"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型状态操作码，0成功；1开发类错误，修改失败(表单不存在或字段类型不是数值类型)；2应用层规则拦截，拦截后可以小白开放平台查看日记
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.items字符串查找到的下拉列表数据，每个元素为字段值。
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

1846 批量替换字符串字段

接口路径(新)：http://hd215.api.yesapi.cn/api/App/SuperTable/FreeReplace

接口路径(旧)：http://hd215.api.yesapi.cn/?s=App.SuperTable.FreeReplace

接口描述： 批量 改 针对表单的单个字段，根据指定的查找值和替换值进行自定义条件的批量替换

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
model_name字符串必须数据库表名
database字符串可选super自己的数据库配置标记，注意！这是数据库的配置标识，不是数据库的名称。默认使用super，不用传。如果需要配置多个数据库时，可与小白技术人员联系。重要事情说三遍，这是数据配置标识，不是数据库名称。使用此接口前，请先进入：数据库直连服务配置。
field_name字符串必须字段名称，需要替换的字段名
from_str字符串必须要替换的子字符串
to_str字符串必须新的替换子字符串，不能和from_str一样
logic枚举类型可选and范围：and/orwhere条件的逻辑组合，logic=and表示逻辑且，logic=or表示逻辑或
where字符串JSON格式可选[["id", ">=", "1"]]SQL语句的WHERE查询条件，JSON格式，格式为：[第一组条件, 第二组条件, ……]。（where和where_X二选一，不可混用，以where_X优先）

写法1：每一组的条件格式为：["字段名", "比较符", "比较值"]，其中：
  • 字段名：表单结构中存在的字段，或表字段
  • 比较符：比较符号可以是>、>=、<、<=、<>、!=、EQ、GT、GE、LT、LE、NE、LIKE、NLIKE、IN、NIN、BETWEEN、NBETWEEN
  • 比较值：需要比较的值，不同比较符的比较值格式会有所不同。如果字段是数值类型，请传递数值类型，不要用字符串。
示例：当logic=and, where=[["id",">",9],["id","<=",10]]，则表示：id > 9 AND id <= 10。

写法2（Beta）：每一组的条件格式可以为：MySQL条件字符串，支持嵌套、组合、函数等，功能更强大，组合更灵活，但要求：
  • 必须符合MySQL语法
  • 一些疑似危险的操作已被禁止
  • 建议掌握MySQL语法的专业开发者使用，并且使用静态参数，开启接口签名，以防SQL注入攻击
示例：当logic=and, where=["id > 9", "id <= 10"]，则表示：id > 9 AND id <= 10。

以上两种写法可以混合使用。如果需要有效防止SQL注入，请用写法1；如果需要更强大的条件组合，并且是固定参数条件时，可用写法2。更多示例说明请参考WHERE参数介绍。
where_X字符串可选动态条件，优先于where的JSON数据，简化的where条件，更易使用但只支持部分比较符。条件格式：where_ + X（X要换成你的字段名） = 比较符（见下方） + 中横线（-） + 比较值。支持的比较符和示例如下：
  • EQ：等于（默认），如：where_year=EQ-2020，或：where_year=2020，表示年份year等于2020；
  • GT：大于，如：where_year=GT-2020，表示年份year大于2020；
  • GE：大于等于，如：where_year=GE-2020，表示年份year大于或等于2020；
  • LT：小于，如：where_year=LT-2020，表示年份year小于2020；
  • LE：大于等于，如：where_year=LE-2020，表示年份year小于或等于2020；
  • NE：不等于，如：where_year=NE-2020，表示年份year不等于2020；
  • LIKE：模糊匹配，如：where_name=LIKE-小白，表示名字name含有小白的；
  • NLIKE：模糊匹配（排除），如：where_name=NLIKE-小白，表示名字name不包含小白的
  • IN：枚举查询，如：where_year=IN-2020,2021,2022，表示年份year在这三个年份，多个值用英文逗号分割
  • NIN：枚举查询（排除），如：where_year=NIN-2020,2021,2022，表示年份year不在这三个年份，多个值用英文逗号分割
如果同一字段有多个条件，使用双竖线||分割，如：where_year=GT-2000||LT-2020，表示year年份大于2020（logic=and或logic=or）小于2020。（where和where_X二选一，不可混用，以where_X优先）

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作状态码，0表示成功，1表示更新失败，2表示表单规则不通过
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
data.update_total整型成功更新的数量
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单

特别注意：当前 hd215.api.yesapi.cn 为临时接口测试域名！请先完成 绑定独立接口域名后 ，才能正式进行API调用。

由 果创云YesApi.cn 提供技术支持，4万+开发者都在用，累计API调用1,800,000＋万次