It doesn’t matter what your API design processes are and what tools you are using if you cannot do it reliably. If you aren’t monitoring, testing, securing, and understanding performance, consumption, and limitations across ALL of your API infrastructure, then there will never be the perfect API solution. If your web API infrastructure isn’t reliable, consumers will not build trust or increase the depth and scope of their integration, making a successful API toolbox more about doing APIs well, than it will ever be about any particular protocol, technology, and proprietary solution.
Web APIs, hypermedia, GraphQL, Webhooks, Server-Sent Events, Websockets, Kafka, gRPC, and any other approach will always be inadequate if you cannot reliably operate them. Every tool within your API design toolbox should be able to be effectively deployed, thoughtfully managed, and coherently monitored, tested, secured, and delivered as a reliable service. If you don’t understand what is happening under the hood with any of your API infrastructure, out of your league technically, or kept in the dark through vendor magic, it should NOT be a tool in your toolbox, and be something that left in the R&D lab until you can prove that you can reliably deliver, support, scale, and evolve something that is in alignment with, and has purpose augmenting and working with your existing API infrastructure. https://goo.gl/M6ccd4
