RAML Open Specification And Tools Released To Aid In API Design

Adam DuVander, October 23rd, 2013

A new API description language is looking to help out where many modern APIs get stuck: at the design phase. Officially announced, today, the RESTful API Modeling Langauge (aka RAML) offers a format friendly to both humans and machines. It also centers on re-use of results within responses. Like other description languages, it also offers the potential for post-design benefits such as streamlining documentation, enabling interactive consoles and generating client libraries. Though not formally announced at the time, the format was originally revealed earlier this month.

531 Reference APIs: GeoNames, Wikipedia and CrunchBase

Wendell Santos, July 31st, 2013

GeoNamesOur API directory now includes 531 reference APIs. The newest is the CanLII API. The most popular, in terms of mashups, is the GeoNames API. We list 88 GeoNames mashups. Below you’ll find some more stats from the directory, including the entire list of reference APIs.

Swagger Offers Lightning Quick Connection To Your API

Romin Irani, July 23rd, 2013

WordnikAs APIs explode, one of the key metrics to successful API adoption is Time To First Hello World (TTFHW). And one way of getting that done is to providie API Documentation that helps developers get going quickly. But simply listing down your API methods and request/response formats is not going to cut it anymore. This is the age of interactive API documentation where developers can try out your API by exercising the methods and various parameters from right within your Developer Portal.

From Printing Press to API: Book Publishers’ Revolutionary Tools

Greg Bates, March 11th, 2013

WordnikBefore 1500, monks spent their lives copying the Bible by hand. That method was replaced by printing presses for the next 500 years. Today, ebooks are set to end the practice of pulping trees and smearing them with ink. In all this change the direction of information access has been constant for half a millennium: faster and faster, easier and easier. The next revolution for publishers is APIs for books.

Swagger, the Interactive API Documentation Framework that Benefits both API Providers and Consumers

Janet Wagner, February 19th, 2013

ReverbLast month ProgrammableWeb reported that Wordnik, a popular online dictionary and provider of the Wordnik API, had launched a brand new company called Reverb. Reverb is home to several developer tools including Swagger, a complete framework for “describing, producing, consuming, and visualizing RESTful web services.” This post is an overview of the Swagger interactive API documentation specification and framework.

Wordnik Launches Reverb, a New Company Offering Tools For Increasing Content Discovery and Engagement

Janet Wagner, January 25th, 2013

WordnikWordnik, a popular online dictionary and words related content platform, has just launched a brand new company called Reverb. Reverb will be the new home of the Wordnik API as well as expand on the Wordnik platform offering tools that “find and connect the rich associations between words, ideas, content, and people.”

API Strategy and Practice Conference: Including PW Reader Discount

Janet Wagner, October 4th, 2012

API Strategy and Practice ConferenceLast month, ProgrammableWeb published a post announcing that the first “API Strategy and Practice Conference” would be taking place the 1st and 2nd of November in New York City. New speakers and panel sessions have been added to the conference events schedule since the time the original post was published.

Using Color in API Documentation

Guest Author, September 28th, 2012

There’s a lot that’s been written about the content of API documentation, but what about its look-and-feel? Unlike many types of information, API documentation is not meant to be read front-to-back, but is meant to be scanned for relevant information. This means that the look-and-feel should be very clean. Clarity is a much higher priority than aesthetics.

Flexible and Collaborative API Design and Documentation with Apiary.io

Kin Lane, June 27th, 2012

A big part of APIs success is the agility and flexibility they introduce into development and business processes by providing self-service, valuable, programmatic interfaces that can be used to quickly deliver new resources or data, allowing collaboration between 3rd party groups. With all of this flexibility and collaboration, often times many APIs are designed and developed in isolation, without much interaction with the consumers who will actually be using the interface. apiary.io, a new API service provider is looking to change all of this with their new collaborative, REST API documentation platform.

Reaching a Million APIs and What to do When We Get There

Guest Author, June 5th, 2012

The number of APIs available across the public Internet has grown phenomenally in the past few years – with ProgrammableWeb’s directory now reaching 6000 APIs listed, with a 1000 APIs added in just the last 3 months.

While this number is large, it remains tiny compared to the many millions of sites that make up the World Wide Web. However, as code frameworks in major languages and platforms of various types make it increasingly easy to launch and operate APIs it is likely that “web scale” thinking will be needed to manage the resulting API Web.

Follow the PW team on Twitter

APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.