目前公司的项目对外交互都是采用 http resful 的协议进行通信, 数据格式采用 JSON RESTFUl 的风格, 这种组合比较轻量级, 基本抛弃过去的 xml 格式. 但是在互联网后台服务中, 都是采用分布式系统, 会将一个大的项目拆分成多个小的子系统, 每个团队各负责一个部分, 这个时候, 如何定义各系统的之间的接口以及如何就接口进行展示和沟通, 往往是一个头疼的问题. 之前的项目开发中, 一直采用纯粹的文档的形式, 随着业务的变化, 维护文档的更新是一个非常耗时耗力的事情. 这段时间看到了一个开源项目 swagger, 提供了一种从项目代码中自动生成接口文档的功能, 可以保持和代码的同步变化, 非常强大. 其中与 Spring 整合版本是 Spring-Fox 的开源项目, 已经和 Spring 框架进行了非常好的整合. 本文将对 Swagger 进行简单的一个介绍和 Demo 的实现.

本文首发于Gevin的博客 原文链接：RESTful API 编写指南 未经 Gevin 授权，禁止转载 基于一些不错的RESTful开发组件，可以快速的开发出不错的RESTful API，但如果不了解开发规范的、健壮的RESTful API的基本面，即便优秀的RESTful开…

现在看来，REST 在 2000 年那个时代确实是超前于时代的。但是 Web 开发者社区对于 HTTP 的设计意图存在着大量的误解，由此导致了对于 HTTP 的大量低效率的误用。 需要注意的是，REST 是一种设计风格而不是标准，如果一个架构符合 REST 原则，我们就称它为 RESTful 架构。

接口调试是每一个软件开发从业者必不可少的一项技能，一个项目的完成必然经过大量的接口测试，实际开发过程中，接口调试的时间不比实际开发所用的时间少。 作为前端开发人员，我们通常使用 Postman（或 PostWoman 等 ） 工具来进行REST API调用。 Postman 用…

权限是根据系统设置的安全规则或者安全策略，用户可以访问而且只能访问自己被授权的资源。在实际的生产系统中，用户数量十分庞大，权限的划分需要结合具体的业务场景，一旦把控不住力度，工作十分繁重，如何解决这个问题？

当我们开始从事 API 开发的时候，设计问题便出现了. 一个强而有力的 API 设计方法是 API 成功的关键要素. 设计糟糕的 API 会导致 API 滥用问题，或者更糟：API 根本没人使用 (指 Web 开发者).

本文首发于Gevin的博客 原文链接：RESTful 架构风格概述 未经Gevin授权，禁止转载 在移动互联网的大潮下，随着docker等技术的兴起，『微服务』的概念也越来越被大家接受并应用于实践，日益增多的web service逐渐统一于RESTful 架构风格，如果开发者对…

移动互联网时代，RESTful API 成为越来越重要的移动端和服务器端交互的形式。尤其是在很多互联网公司或者传统行业拥抱移动互联网的时候，一套设计良好的 Restful API 能够帮助互联网产品支持单服务端＋多客户端的场景。RESTful 架构本身是一个风格而不是一个标准，这也就意味着在具体设计时会有不同的实现。那么什么是好的 RESTful API 呢？笔者认为适合的是最好的，能够根据本身产品的业务场景和阶段设计出结构清晰，易于理解，扩展方便的 Restful API 就是最好的。本文将围绕笔者对 Restful 架构的理解展开讨论，欢迎大家拍砖。

1. 获取首页推荐信息 2. 获取排行榜信息 3. 获取歌曲列表 4. 获取歌曲播放 url 本接口仅用作学习交流之用, 请不要用在不正当手段. 测试服务没有做任何处理, 扛不住 ddos 等等各种攻击, 希望大佬手下留情.