Observations on API and Mashup Management

API and Mashup Blog

Latest News

    Archives

    Tags

    amazon analytics announcement API API best practices Apigee API management API news API Tips Apple case study chrip cloud API consumer debug Design developers E*Trade errors example facebook facebook api feature features geo-ip gluecon howto HTTP latency mashup monitoring new APIs OAuth performance proxy response time testing twitter Twitter API video

    Subscribe to This Blog

    sonoa Learn more about the company behind Apigee

    API Tip of the Day: Reduce the Learning Curve

    Be consistent when building your API, and try to use standard conventions when possible. This will reduce the learning curve for 3rd party developers.

    API Tip of the Day: Self documenting code is an ideal

    Read the API carefully as you write it.  Does it read clearly?  Can new users make sense of it quickly?  Twitter’s “statuses/mentions” is a good example – you’ll HTTP GET the mentions of the user account you’re calling from.  Readable APIs mean easy-to-adopt APIs.

    API Tip of the Day: Involve the users early

    Your API exists for the use of developers.  You’ll probably get it wrong the first time.  With a tight feedback loop between developers who use the API and those who build the API you can get it right quickly.  In turn these early users will help promote the API and help new users get productive.

    •  1 2 >