[最近晒代码的“多隆奖”热火朝天。
不过对于刚入门的新手，做得最多的事情也许不是打代码，而是搭建各种环境、学习各种工具使用、尝试自己造“轮子”。作为新手有很多不懂的地方，容易犯一些哭笑不得的错误，也容易掉入各种坑。这时候一份良心的文档就非常重要了。
题主查看Google文档的时候，注意到底部有标明作者，也会默默为她点赞。
Google_Chrome說明
咱们阿里云也有很多良心的文档。题主也很想知道默默细心为阿里云一众新手写文档的小哥是谁呢！云栖社区的各位大神是否也贡献了文档呢？
如果你是一位学习多门编程语言、多个平台和多个工具的开发者，常年混迹于多个开源社区、开发者社区和博客网站，你可能会发现有不少平台和工具的文档还不够完善和易读。这可能是因为社区文档团队人手不足、时间仓促，也可能是写文档的大神没有想到新手哪里会不懂。
作为新手，你最喜欢什么样的文档？作为大神，你愿意为新手提供一份良心的文档吗？让我们一起来晒文档、写文档、改文档，为新手铺平进阶之路吧！
欢迎大家分享：
1、新手们晒晒最良心的文档。文档良心在哪里？带给你什么帮助？
2、开发者们列出存在不足甚至处于空白的文档。哪些文档需要补充和完善？
3、大神们来分享自己写的文档和教程吧！
参与话题
奖品区域 活动规则 1月后 结束

奖品一
阿里云代金券 x 3

奖品二
云栖帽衫 x 1

奖品三
品牌U盘 x 1

10个回答
1
微wx笑 专家认证复制链接去分享
贴一段通过工具生成的，大家指点指点：

购置方式相关操作接口
分页查询购置方式列表接口
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 |结果实体对象列表
|colmodel |List |表结构列名列表

查询购置方式列表接口
http://IP:Port/ProjectName/mobileapi/buyMode/findList.do?token=9DB2FD6FDD2F116CD47CE6C48B3047EE
Method:GET
参数列表:
 参数名 类型 必需 描述
token String Y 令牌

返回值：
|参数名 |类型 |描述
|code |String |响应代码
|result |String |响应说明
|BuyModeList |List|购置方式实体类列表

保存或更新购置方式信息接口
添加或修改购置方式信息接口
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 |序号请添加链接描述](http://click.aliyun.com/m/49926/)