靠谱的API设计（描述）语言

Question

需要设计一个全新的Web API Service站点
N多对外接口需要设计
希望有一个靠谱的，最好是社区比较成熟的API设计语言帮助我进行设计、描述

Answer 1

推荐阅读:

• http-api-design，它介绍了HTTP+API设计的最佳实践，是Heroku PASS平台的实践精华。
• Principles of Good RESTFul API Design

另外，推荐一个工具prmd，它可以帮你管理和生成描述HTTP APIs的JSON数据接口的文档，其中文档规范的定义是基于json-schema的。

Answer 2

难道不是采用RESTful风格吗？
http://www.ruanyifeng.com/blog/2011/09/restful.html
http://zh.wikipedia.org/wiki/REST

Answer 3

https://github.com/cocoajin/http-api-design-ZH_CN
是个好东西

Answer 4

如果你不怕麻烦的话，可以考虑一下 IDL，个人认为是比较成熟的
http://zh.wikipedia.org/wiki/%E6%8E%A5%E5%8F%A3%E6%8F%8F%E8%BF%B0%E8%AF%AD%E8%A8%80

Answer 5

haoservice 已经做成了，你去网站看看吧！