3183183.请求中的 / 需要转义。JSONRequest.java已经用URLEncoder.encode转义，不需要再写；但如果是浏览器或Postman等直接输入url/request，需要把request中的所有 / 都改成 %252F 。下同。<br >
3193194.code，指返回结果中的状态码，200表示成功，其它都是错误码，值全部都是HTTP标准状态码。下同。<br >
3203205.msg，指返回结果中的状态信息，对成功结果或错误原因的详细说明。下同。<br >
321- 6.code和msg总是在返回结果的同一层级成对出现。对所有请求的返回结果都会在最外层有一对总结式code和msg。对非GET类型的请求，返回结果里面的每个JSONObject里都会有一对code和msg说明这个JSONObject的状态。 下同。<br >
321+ 6.code和msg总是在返回结果的同一层级成对出现。对所有请求的返回结果都会在最外层有一对总结式code和msg。下同。<br >
3223227.id等字段对应的值仅供说明，不一定是数据库里存在的，请求里用的是真实存在的值。下同。
323323
324324<br />
@@ -334,7 +334,7 @@ GET: <br > 普通获取数据，<br > 可用浏览器调试 | base_url/get/ | {<
334334HEAD: <br > 普通获取数量，<br > 可用浏览器调试 | base_url/head/ | {<br > TableName:{<br > …<br > }<br > } <br > {…}内为限制条件 <br ><br > 例如获取一个 id = 38710 的 User 所发布的 Moment 总数：<br >{<br > "Moment":{<br > "userId":38710<br > }<br >} <br > 后端校验通过后自动解析为 SQL 并执行：<br >`SELECT count(*) FROM Moment WHERE userId=38710 LIMIT 1` | {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "count":10<br > },<br > "code":200,<br > "msg":"success"<br >} <br > 例如<br >{<br > "Moment":{<br > "code":200,<br > "msg":"success",<br > "count":10<br > },<br > "code":200,<br > "msg":"success"<br >}
335335GETS: <br > 安全/私密获取数据，<br > 用于获取钱包等<br >对安全性要求高的数据 | base_url/gets/ | 最外层加一个 "tag": tag ，其它同GET | 同GET
336336HEADS: <br > 安全/私密获取数量，<br > 用于获取银行卡数量等<br >对安全性要求高的数据总数 | base_url/heads/ | 最外层加一个 "tag": tag ，其它同HEAD | 同HEAD
337- POST: <br > 新增数据 | base_url/post/ | 单个： <br > {<br > TableName:{<br > …<br > },<br > "tag":tag<br >} <br > {…}中id由后端生成，不能传 <br ><br >例如当前登录用户 38710 发布一个新 Comment：<br >{<br > "Comment":{<br > "momentId":12,<br > "content":"APIJSON,let interfaces and documents go to hell !", <br > },<br > "tag":"Comment"<br >} <br > 后端校验通过后自动解析为 SQL 并执行：<br >`INSERT INTO Comment(userId,momentId,content) VALUES(38710,12,'APIJSON,let interfaces and documents go to hell !')` <br > <br > 批量： <br > {<br > TableName\[]:\[{<br > …<br > }, {<br > …<br > }<br > …<br > ],<br > "tag":tag<br >} <br > {…}中id由后端生成，不能传 <br ><br >例如当前登录用户 82001 发布 2 个 Comment：<br >{<br > "Comment\[]":\[{<br > "momentId":12,<br > "content":"APIJSON,let interfaces and documents go to hell !"<br > }, {<br > "momentId":15,<br > "content":"APIJSON is a JSON transmision protocol."<br > }],<br > "tag":"Comment:[]"<br >}<br > 后端校验通过后自动解析为 SQL 并执行：<br >`INSERT INTO Comment(userId,momentId,content) VALUES(82001,12,'APIJSON,let interfaces and documents go to hell !')`<br >`INSERT INTO Comment(userId,momentId,content) VALUES(82001,15,'APIJSON is a JSON transmision protocol.')` | 单个： <br > {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "id":38710<br > },<br > "code":200,<br > "msg":"success"<br >}<br >例如<br >{<br > "Comment":{<br > "code":200,<br > "msg":"success",<br > "id":120<br > },<br > "code":200,<br > "msg":"success"<br >} <br > <br > 批量： <br > {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "count":5,<br > "id[]":[1, 2, 3, 4, 5]<br > },<br > "code":200,<br > "msg":"success"<br >}<br >例如<br >{<br > "Comment":{<br > "code":200,<br > "msg":"success",<br > "count":2,<br > "id[]":\[1, 2]<br > },<br > "code":200,<br > "msg":"success"<br >}
337+ POST: <br > 新增数据 | base_url/post/ | 单个： <br > {<br > TableName:{<br > …<br > },<br > "tag":tag<br >} <br > {…}中id由后端生成，不能传 <br ><br >例如当前登录用户 38710 发布一个新 Comment：<br >{<br > "Comment":{<br > "momentId":12,<br > "content":"APIJSON,let interfaces and documents go to hell !" <br > },<br > "tag":"Comment"<br >} <br > 后端校验通过后自动解析为 SQL 并执行：<br >`INSERT INTO Comment(userId,momentId,content) VALUES(38710,12,'APIJSON,let interfaces and documents go to hell !')` <br > <br > 批量： <br > {<br > TableName\[]:\[{<br > …<br > }, {<br > …<br > }<br > …<br > ],<br > "tag":tag<br >} <br > {…}中id由后端生成，不能传 <br ><br >例如当前登录用户 82001 发布 2 个 Comment：<br >{<br > "Comment\[]":\[{<br > "momentId":12,<br > "content":"APIJSON,let interfaces and documents go to hell !"<br > }, {<br > "momentId":15,<br > "content":"APIJSON is a JSON transmision protocol."<br > }],<br > "tag":"Comment:[]"<br >}<br > 后端校验通过后自动解析为 SQL 并执行：<br >`INSERT INTO Comment(userId,momentId,content) VALUES(82001,12,'APIJSON,let interfaces and documents go to hell !')`<br >`INSERT INTO Comment(userId,momentId,content) VALUES(82001,15,'APIJSON is a JSON transmision protocol.')` | 单个： <br > {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "id":38710<br > },<br > "code":200,<br > "msg":"success"<br >}<br >例如<br >{<br > "Comment":{<br > "code":200,<br > "msg":"success",<br > "id":120<br > },<br > "code":200,<br > "msg":"success"<br >} <br > <br > 批量： <br > {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "count":5,<br > "id[]":[1, 2, 3, 4, 5]<br > },<br > "code":200,<br > "msg":"success"<br >}<br >例如<br >{<br > "Comment":{<br > "code":200,<br > "msg":"success",<br > "count":2,<br > "id[]":\[1, 2]<br > },<br > "code":200,<br > "msg":"success"<br >}
338338PUT: <br > 修改数据，<br > 只修改所传的字段 | base_url/put/ | {<br > TableName:{<br > "id":id,<br > …<br > },<br > "tag":tag<br >} <br > {…} 中 id 或 id{} 至少传一个 <br ><br >例如当前登录用户 82001 修改 id = 235 的 Moment 的 content：<br >{<br > "Moment":{<br > "id":235,<br > "content":"APIJSON,let interfaces and documents go to hell !"<br > },<br > "tag":"Moment"<br >} <br > 后端校验通过后自动解析为 SQL 并执行：<br >`UPDATE Moment SET content='APIJSON,let interfaces and documents go to hell !' WHERE id=235 AND userId=82001 LIMIT 1` <br ><br > 批量除了 id{}:\[] 也可类似批量 POST，只是每个 {...} 里面都必须有 id。<br >"tag":"Comment[]" 对应对象 "Comment":{"id{}":[1,2,3]}，表示指定记录全部统一设置；<br >"tag":"Comment:[]" 多了冒号，对应数组 "Comment[]":[{"id":1},{"id":2},{"id":3}]，表示每项单独设置 | 同POST
339339DELETE: <br > 删除数据 | base_url/delete/ | {<br > TableName:{<br > "id":id<br > },<br > "tag":tag<br >} <br > {…} 中 id 或 id{} 至少传一个，一般只传 id 或 id{} <br ><br >例如当前登录用户 82001 批量删除 id = 100,110,120 的 Comment：<br >{<br > "Comment":{<br > "id{}":[100,110,120]<br > },<br > "tag":"Comment[]"<br >} <br > 后端校验通过后自动解析为 SQL 并执行：<br >`DELETE FROM Comment WHERE id IN(100,110,120) AND userId=82001 LIMIT 3` | {<br > TableName:{<br > "code":200,<br > "msg":"success",<br > "id[]":[100,110,120]<br > "count":3<br > },<br > "code":200,<br > "msg":"success"<br >}<br >例如<br >{<br > "Comment":{<br > "code":200,<br > "msg":"success",<br > "id[]":[100,110,120],<br > "count":3<br > },<br > "code":200,<br > "msg":"success"<br >}
340340
0 commit comments