April 22, 2013 
0 Comments
apiDoc creates a documentation of your embedded API descriptions in your application source code. With an integrated template you generate a standalone usable website with the API documentation. Own templates can be used. Highlight is an API history, with that various API version levels can be compared. So you, or a frontend developer, can retrace what changes in the API since the last version.
(Full Story: http://apidocjs.com/ )
March 12, 2013 0 Comments
Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services. The overarching goal of Swagger is to enable client and documentation systems to update at the same pace as the server. The documentation of methods, parameters, and models are tightly integrated into the server code, allowing APIs to always stay in sync. With Swagger, deploying managing, and using powerful APIs has never been easier.
(Full Story: https://developers.helloreverb.com/swagger/ )
January 21, 2013 0 Comments
a REST API tool that makes it easy to create documentation and other tools for your users to use your API. It even includes tools to get the community to create your documentation for you on GitHub.
(Full Story: http://apiary.io/ )
December 7, 2011 0 Comments
ql.io combines SQL, JSON, and a few procedural style constructs into a compact language. Scripts written in this language can make HTTP requests to retrieve data, perform joins between API responses, project responses, or even make requests in a loop. But note that ql.io’s scripting language is not SQL – it is SQL inspired.
(Full Story: ql.io – a SQL and JSON inspired DSL)
October 4, 2011 0 Comments
Tell me more: documentation is king
Let me in: all about authentication
Underlying design: REST or something like it
(Full Story: API design for humans – (37signals))
September 29, 2011 0 Comments
Cons1. Javascript Frameworks are still evolving2. Developing two applications instead of one
Pros1. Well thought out and tested API2. Your JS UI code as API reference
(Full Story: The pros and cons of developing a complete Javascript UI)
August 31, 2011 0 Comments
Characteristics of Good API
(Full Story: The Little Manual of API Design)
August 21, 2011 0 Comments
Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services. The overarching goal of Swagger is to enable client and documentation systems to update at the same pace as the server. The documentation of methods, parameters and models are tightly integrated into the server code, allowing APIs to always stay in sync. With Swagger, deploying managing, and using powerful APIs has never been easier.
(Full Story: Swagger: A simple, open standard for describing REST APIs with JSON)
August 14, 2011 0 Comments
Cons1. Javascript Frameworks are still evolving2. Developing two applications instead of one
Pros1. Well thought out and tested API2. Your JS UI code as API reference
(Full Story: The pros and cons of developing a complete Javascript UI)
May 16, 2011 0 Comments
There are other ways of describing APIs. For SOAP APIs, there are WSDL files that show methods of inputs. For REST there is WADL, but even its apparent simplicity has been too complex for some. At the very least, support for WADL has been minimal. It’s unclear whether Google has created generic enough to work for other API providers. However, it’s obviously something that Google saw the need for, at least internally.
The Google API Discovery API is one of two APIs for APIs.
(Full Story: Google’s API for APIs Makes Sense of Its 80+ Services)
