Posts Tagged: developer experience

Best Practices for API Error Handling

Best Practices for API Error Handling

Error codes are almost the last thing that you want to see in an API response. Generally speaking, it means one of two things — something was so wrong in your request or your handling that the API simply couldn’t parse the passed data, or the API itself has so many problems that even the most well-formed request is going to fail. Read more

API Mediation: Why You Need an API Experience Layer

The API economy has ushered in a new era of application integration, causing a sea change across enterprise IT and application providers alike. APIs are providing access to data securely across firewalls, enabling new business models and offering a platform that supports the development of new digital products. Read more

Great APIs Are Like Lego Bricks

We’ve written plenty about different API monetization models and monetizing your API using a freemium model in the past, but just as important is envisioning how your API might fit into your business model as a whole.

Obviously, this is something that will differ hugely from company to company — in the case of a business like Twilio, the API is the core product. Read more

The End of API Documentation As We Know It

On the one hand, having proper API documentation can be a sign of early success for an API provider, allowing new users to effectively understand the functionalities and caveats behind an API solution.

On the other hand, extensive documentation could indicate an overly complex solution with far too many variables to navigate. Read more

3 Ways to Organize Your API Developer Docs

Designing and writing good API documentation can be a daunting task, but is critical for any API-driven or B2D (Business 2 Developer) company to ensure developer success. Your documentation is also your company’s marketing asset and may be the first few pages a new prospect visits to assess how difficult your integration is and how the product works. Read more