More than ten years ago, software architect Kevin Perera invented a design method for architectures that was called "metadata-driven design and development". In this article, Aaron Kendall explains how to use this design method and outlines similarities as well as differences to current techniques like RESTful services or HATEOAS by implementing a metadata-driven mobile application.
As this article’s author, Mark Foster, puts it, "Absent profiles, the API space will be relegated to blindly passing around 'magic strings, fooling ourselves into thinking we are passing reliable semantic information." Here, Foster — one of the editors of the ALPS specification — explains what semantic profiles are and how they can transform the way Web APIs are desgined and implemented.
Erik Wilde talks to Mike Amundsen about Profiles, Description, Documentation, Discovery, his Sedola project and the future of Web-level metadata for APIs.
In the fast growing world of APIs and microservices, finding just the right API when you are developing a web, or mobile application, is always a tedious task.
Suman Pradhan has written about developing the CORE approach to helping architects and developers build sustainable solutions that match the business needs.
After a flurry of activity from thier open working group Swagger 2.0 was officially released in September 2014. Since then responsibliity for leading Swagger would be handed over to SmartBear.
RAML, or the RESTful API Modeling Language, is a relatively new spec based on the YAML format- making it easily read by both humans and machines. 2
This series focuses on three key areas of "meta-language" for Web APIs: API Description, API Discovery, and API Profiles.
Designing a good API is hard work and it’s easy to feel overwhelmed when it’s your job to make one. 1
While the process of implementing Web APIs has become common, the tooling for describing, discovering, and understanding the meaning of the tens of thousands of API-based services has yet to settle. 1
In this article, authors provide an overview of current SOA technologies and incremental transition to SOA in legacy environments. They also discuss web services & enterprise application integration. 6
Rounding out our first Web APIs series Mike shares books he recommends for those who want to learn more about designing, implementing, and maintaining APIs for the Web.
CONTENT IN THIS BOX PROVIDED BY OUR SPONSOR
5 OAuth Essentials for API Access Control.
OAuth standardizes a number of important access-related challenges for API publishers. However, deploying OAuth as an authorization mechanism for enterprise APIs raises challenges around scalability...
5 Pillars of API Management.
The boundaries of the traditional enterprise are blurring, as organizations open their on-premise data and application functionality for use in new internal and external applications...
A Guide to REST and API Design.
“If all you have is a hammer, then everything looks like a nail,” said American psychologist Abraham Maslow as he tackled the idea that those in the field of psychology needed to approach treatment from multiple perspectives...
A How-to Guide to OAuth & API Security.
OAuth is an emerging Web standard that lets users grant third-party clients restricted access to resources they own. In the past, it was common to ask a user to...
Protecting Your APIs Against Attack and Hijack.
The application programming interface (API) is an emerging technology for integrating applications using Web technology. This approach is exploding in popularity...
5 Ways to Get Top Mobile Developer Talent for your Open APIs.
In this eBook, we will provide a detailed overview of five key ways smart enterprises attract and nurture top third-party developer talent...