Posts Tagged: YAML

Should You Design Natural Language First APIs?

Humans are getting lazier, but APIs tend to stay pretty complicated. Wouldn’t it be nice if we could, instead, speak in plain language to automatically initiate any change in the backend? For some scenarios, a natural language facade may just be where web APIs are heading. Read more

7 Protocols Good For Documenting With AsyncAPI

Documentation is arguably the most important part of any API strategy, as it’s often the direct route between developer and user, and a direct conduit through which the developer can inform, educate, and contextualize. Accordingly, finding good options for documenting your API is of prime importance. Read more

Tooling Review: AsyncAPI

Documentation will set you free – this is a mantra often delivered by experienced developers, and it bears repeating whenever the value of documentation is discussed. Simply put, documentation is perhaps one of the most important elements of effective API developer communication, second only to active demonstrations, tutorials, and other interactive systems. Read more

Standard API Definitions Demystified

As with any industry, the web API space faces different approaches to standardization. Not least of which are the differences between how API providers choose to define their APIs in a machine readable way with API specifications and description languages.

API definitions have emerged as ways to annotate API functionalities, and there are still many out there catering to varying web service architectures. Read more

What Data Formats Should My API Support?

When considering the design, implementation, and maintenance of APIs, one of the most important factors to consider is data formats — how the API handles the interaction between data generation and data request. This path between generation and manipulation, typically between server and client, is the crux of the API ecosystem. Read more