OpenAPI Specification v2.0 – formerly known as Swagger RESTful API Documentation Specification.
Swagger™ is a project used to describe and document RESTful APIs.
The Swagger specification defines a set of files required to describe such an API. These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in various languages. Additional utilities can also take advantage of the resulting files, such as testing tools.
Slashdot is running the story about the Google vs. Oracle court case. I thought this bit was rather brilliant:
Schwartz’s second attempt at the breakfast menu analogy went much better, as he explained that although two different restaurants could have hamburgers on the menu, the actual hamburgers themselves were different — the terms on the menu were an API, and the hamburgers were implementations.”
An API is a user interface for developers. Put the effort in to ensure it’s not just functional but pleasant to use.
Vinay Sahni has a rather lengthy, detailed, and well-rounded post on how to design a good RESTful API. It covers pretty much everything from URL structures and parameters, request methods, to error handling, documentation, and coding style.
FOASS gotta be one of the funniest things I’ve seen recently. All we need now are some comments on the API design from all those noisy “this is how you do REST” people. Who, by the way, can f*ck off. :)
OverAPI.com – Collecting All Cheat Sheets
Twilio – APIs for Text Messaging, VoIP & Voice in the Cloud.
Stack – reusable middleware with PHP
RequestBin gives you a URL that will collect requests made to it and let you inspect them in a human-friendly way. Use RequestBin to see what your HTTP client is sending or to inspect and debug webhook requests.
Open-source developers all over the world are working on millions of projects: writing code & documentation, fixing & submitting bugs, and so forth. GitHub Archive is a project to record the public GitHub timeline, archive it, and make it easily accessible for further analysis.