靠谱的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的。