In our recent post on tips for starting a public API journey we touched briefly on the idea of creating a style guide that helps API providers produce well-constructed and consistent APIs as part of their public API offering. The creation of an API style guide is, however relevant for API providers regardless of whether they are providing APIs externally or internally: It provides the context for their development efforts whether it be outsourced or created internally and is an important tool for achieving some level of governance across the organization. Read more
Posts Tagged: developer experience
APIs are necessarily a communal endeavor — the community fostered between the users, the providers, and those who depend on the API for the functions of their own services drives the development environment of the API space.
Accordingly, developer outreach is absolutely essential for cultivating an API’s network of users and agents. Read more
How many organizations are adopting an API strategy in Helsinki? Quite a few — for one, Helsinki arguably is the most successful city in the world using open data, with an active developer portal (Dev.Hel.fi) enabling the creation of new applications on top of city data to promote participatory democracy. Read more
According to The State of API Survey Report 2016 by Smartbear, nearly 85% of the respondents agree that API quality is crucial to their organization. The same survey identifies the top three reasons keeping organizations from delivering quality APIs are:
1) Increased demands for speed 2) Lack of integration between tools and systems 3) Managing expectations of different stakeholders
A remedy for the first reason can be found by fine-tuning architecture and optimizing code. Read more