最近晒代码的“多隆奖”热火朝天。
不过对于刚入门的新手，做得最多的事情也许不是打代码，而是搭建各种环境、学习各种工具使用、尝试自己造“轮子”。作为新手有很多不懂的地方，容易犯一些哭笑不得的错误，也容易掉入各种坑。这时候一份良心的文档就非常重要了。
题主查看Google文档的时候，注意到底部有标明作者，也会默默为她点赞。
咱们阿里云也有很多良心的文档。题主也很想知道默默细心为阿里云一众新手写文档的小哥是谁呢！云栖社区的各位大神是否也贡献了文档呢？
如果你是一位学习多门编程语言、多个平台和多个工具的开发者，常年混迹于多个开源社区、开发者社区和博客网站，你可能会发现有不少平台和工具的文档还不够完善和易读。这可能是因为社区文档团队人手不足、时间仓促，也可能是写文档的大神没有想到新手哪里会不懂。
作为新手，你最喜欢什么样的文档？作为大神，你愿意为新手提供一份良心的文档吗？让我们一起来晒文档、写文档、改文档，为新手铺平进阶之路吧！
欢迎大家分享：
1、新手们晒晒最良心的文档。文档良心在哪里？带给你什么帮助？
2、开发者们列出存在不足甚至处于空白的文档。哪些文档需要补充和完善？
3、大神们来分享自己写的文档和教程吧！
奖品区域 活动规则 1月后 结束
10个回答
分页查询购置方式列表接口
http://IP:Port/ProjectName/mobileapi/buyMode/findPage.do?token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:GET
参数列表:
|参数名 |类型 |必需 |描述
|----- |---- |---- |----
|token |String |Y |令牌
|start |Integer |N |分页开始加载记录索引，从0开始
|limit |Integer |N |每页多少条数据
返回值：
|参数名 |类型 |描述
|total |Integer |总记录数
|rows |List<BuyMode> |结果实体对象列表
|colmodel |List<Column> |表结构列名列表
查询购置方式列表接口
http://IP:Port/ProjectName/mobileapi/buyMode/findList.do?token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:GET
参数列表:
|参数名 |类型 |必需 |描述
|----- |---- |---- |----
|token |String |Y |令牌
返回值：
|参数名 |类型 |描述
|code |String |响应代码
|result |String |响应说明
|BuyModeList |List<BuyMode>|购置方式实体类列表
保存或更新购置方式信息接口
添加或修改购置方式信息接口
http://IP:Port/ProjectName/mobileapi/buyMode/save.do?token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:POST
参数列表:
|参数名 |类型 |必需 |描述
|----- |---- |---- |----
|token |String |Y |令牌
|id |Long |Y |编号
|companyId |Long |N |公司编号;公司表
|modeName |String |N |购置方式
|orderId |Integer |N |序号
返回值：
|参数名 |类型 |描述
|code |String |响应代码
|result |String |响应说明
|BuyMode |Object |购置方式实体类
删除购置方式接口
http://IP:Port/ProjectName/mobileapi/buyMode/delete.do?ids=1234,12345&token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:POST
参数列表:
|参数名 |类型 |必需 |描述
|----- |---- |---- |----
|token |String |Y |令牌
|ids |String |Y |购置方式编号,可以传一个或多个编号，编号之间用英文半角的逗号“,”分隔。
返回值：
|参数名 |类型 |描述
|code |String |响应代码
|result |String |响应说明
根据 ID 获取购置方式信息接口
http://IP:Port/ProjectName/mobileapi/buyMode/get.do?id=1&token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:GET
参数列表:
|参数名 |类型 |必需 |描述
|----- |---- |---- |----
|token |String |Y |令牌
|id |Long |Y |购置方式编号
返回值：
|参数名 |类型 |描述
|code |String |响应代码
|result |String |响应说明
|BuyMode |Object |购置方式实体类
购置方式实体类字段说明
|id |Long |Y |编号
|companyId |Long |N |公司编号;公司表
|modeName |String |N |购置方式
|orderId |Integer |N |序号