Presentation: TweetBuilding, Running and Promoting a Public API

In this session we are going to share our experience gained while designing and implementing

the Nokia Places API, a public web API used by Nokia-internal application development teams,

external parties with commercial contracts, as well as long-tail developers. We spent six months on initial

development and have been releasing regularly for the two years since.

This experience has yielded interesting lessons about iterative API design,

managing API stability while adding new functionality, and supporting and attracting external clients.

 

Specifically we are going to talk about:

 

* Extensibility and what we might have done differently

* Documentation and how we tried make the API self-explanatory

* Consistency and how Scala helped us to enforce interface patterns

* Backwards compatibility and how we evolved our test strategy to avoid breaking existing clients

* Incompatible changes and how we mitigated the inevitable