We walkthrough using APIcurio, an API design editor supporting OpenAPI Spec.Having a thoroughly documented, machine-readable API is considered top of the line development. However, creating a consistent format for the API and documentation is challenging with no outside guidance or structure. Read more
Posts Tagged: web APIs
What kind of API style should you be using? From SOAP, to REST, GraphQL, and new styles like gRPC, there are many competing standards for designing APIs and the way consumers interact with them. We’ve written about each before, but as the industry changes rapidly, there are always new concerns and opportunities for comparison. Read more
Building a business that relies heavily on APIs is a model that has brought success to many companies. Sometimes success comes in the form of diversified revenue streams, other times it means increasing customer value within the existing ecosystem. API-driven businesses also allow for more third-party innovation, which in turn boosts the success of the business. Read more
HATEOAS is, in essence, a value proposition and definition for what an API should do. HATEOAS, or Hypermedia as the Engine of Application State, is a specific constraint upon the REST architecture. For many, however, HATEOAS seems a nit-picky addition to the slew of API design best practices. Read more
While it’s extremely important to have quality API developer experience, it does not stop at great API design or at the documentation level. One of the most important elements of great developer experience is the SDK.
For app developers, an SDK is often the point of entry to elements within the API. Read more