用户工具

站点工具


api:apijson.md
  • 请求条件:要求POST提交,要求有json正文(logout除外)
  • 子服务说明:
    • get:普通获取数据,{“Moment”:{“id”:12}},响应Moment
    • head:普通获取数量,{“Moment”:{“userId”:38710}},响应count
    • gets:安全/私密获取数据,要求登录,其他同get
    • heads:安全/私密获取数量,要求登录,其他同head
    • post:新增数据,要求有{“tag”:“TableName”},不能传id等值,支持批量“Moment[]”:[{“content”:“test”}]
    • put:修改数据,要求有tag,要求有id或id{},只修改所传的字段
    • delete:删除数据

1. TableName指要查询的数据库表Table的名称字符串。第一个字符为大写字母,剩下的字符要符合英语字母、数字、下划线中的任何一种。对应的值的类型为JSONObject,结构是 {…},里面放的是Table的字段(列名)。下同。 2. “tag”:tag 后面的tag是非GET、HEAD请求中匹配请求的JSON结构的标识,一般是要查询的table的名称,由后端Request表中指定。下同。 3. GET、HEAD请求是开放请求,可任意组合任意嵌套。其它请求为受限制的安全/私密请求,对应的 方法(method), 标识(tag), 版本(version), 结构(structure) 都必须和 后端Request表中所指定的 一一对应,否则请求将不被通过。version 不传、为 null 或 ⇐0 都会使用最高版本,传了其它有效值则会使用最接近它的最低版本。下同。 4. GETS与GET、HEADS与HEAD分别为同一类型的操作方法,请求稍有不同但返回结果相同。下同。 5. 在HTTP通信中,自动化接口(get,gets,head,heads,post,put,delete) 全用HTTP POST请求。下同。 6. 所有JSONObject都视为容器(或者文件夹),结构为 {…} ,里面可以放普通对象或子容器。下同。 7. 每个对象都有一个唯一的路径(或者叫地址),假设对象名为refKey,则用 key0/key1/…/refKey 表示。下同。

  • 功能符

* 单条数据:{“Moment”:{“id”:12}}

  * 部分字段:{"Moment":{"id":12,"@column":"content"}}
  * 字段别名:{"Moment":{"id":12,"@column":"id,date:time,content:text"}}
  * 多条数据:{"[]":{"Moment":{"id{}":[12,15,32],"@column":"id,date,content"}}}
  * 逻辑非:{"[]":{"Moment":{"id!{}":[12,15,32],"@column":"id"}}}
  * 逻辑与:{"[]":{"Moment":{"id&{}":">=300,<=400","@column":"id"}}}
  * 模糊查询:{"[]":{"Moment":{"content$":"%APIJSON%","@column":"id,date,content:text"}}}
  * 正则匹配:{"[]":{"Moment":{"content?":"^[0-9]+$","@column":"id,date,content:text"}}}
  * json数组(老版本MySQL不支持):{"[]":{"Moment":{"praiseUserIdList<>":82001,"@column":"id,date,content,praiseUserIdList"}}}
  * 分页:{"[]":{"Moment":{"@column":"id,date,content,praiseUserIdList"},"page":0,"count":5}}
        * 提取表名:{"Moment[]":{"Moment":{}}},提取字段:{"Moment-id[]":{"Moment":{}}}
  * 查询总数:{"[]":{"Moment":{},"query":1},"total@":"/[]/total","info@":"/[]/info"}
  * 查询某页:{"[]":{"Moment":{"@column":"id"},"query":2,page:1},"total@":"/[]/total"}
  * 排序:{"[]":{"Moment":{"@column":"id,date,content","@order":"date-,id,content+"}}}
  * 关联查询(Access表控制权限和实际表名):{"[]":{"Moment":{"@column":"id,date,userId","id":12},"User":{"id@":"/Moment/userId","@column":"id,name"}}},json数组内id{}@=Moment/praiseUserIdList
  * 最大值:{"[]":{"Moment":{"@column":"max(id):maxid"}}}
api/apijson.md.txt · 最后更改: 2021/03/26 21:26 由 admin