Posts Tagged: complexity

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

Assembling-The-API-Management-Jigsaw-In-Big-And-Small-Companies

Assembling The API Management Jigsaw In Big (And Small) Companies

Have you ever tried to implement a new process in a big company? Believe us when we tell you that it’s not an easy (or fun) task. From obtaining initial approval all the way through to disseminating information, it takes time and there are often bumps along the road. Read more

Sweet API — Syntactic Sugar and You

The internet is bar none the most effective and amazing tool for connecting people. What it’s historically not, however, is an effective and amazing tool for connecting people with systems. While networks form and information is shared, the underlying systems have historically been hidden underneath complex code and abstraction. Read more

How to Provide APIs With an Existing Information System

In a previous article we encouraged every company to join the digital revolution and provide APIs. But when faced with an existing Information System (IS), the steps toward exposing a business process with an API become far more intricate. An IS may be bloated with pre-existing organizational processes and data structures, which, if exposed directly, can make for a very poor user experience, and possibly a complete deadlock. Read more

Balancing Complexity and Simplicity in API Design

The products that excite us today are simple.

Take Apple’s sleek product designs, the negative space of the Google search page, or the single function apps we use on a daily basis.

The idea of erasing clutter permeates into the discussion surrounding APIs or application programming interfaces as well. Read more