Let's face it. API integration sucks. Well one at a time, not so bad. But it's never just a one-and-done scenario. If you are designing and building at least one API integration, odds are you're building 5+ integrations. Each one of those APIs has its own learning curve, its own nuances, its own reasons for going down (or getting updated).
We'll look at some of the trends we are seeing among service providers that improve the developer experience and make some recommendations to ensure the APIs we're building today are fit for purpose tomorrow.
What you'll learn:
-Integration trends for 2018
-Good, usable API design: Eventing, Security, Documentation
-Recap and learnings from The State of API Integration Report 2017
-Sneak peek of The State of API Integration Report 2018, coming in March 2018
5. #SoAI18
@CloudElements
IN A NETWORKED WORLD,
[THE THREE MOST DESIRABLE THINGS ARE]
CONNECTIONS
“
CONNECTIONS
CONNECTIONS
BREAKING SMART, Marc Andreessen & Venkatesh Rao
18. #SoAI18
@CloudElements
“
58% OF ENDPOINTS
SUPPORT SOME
METADATA DISCOVERYOne caveat to this research is that it’s
heavily weighted by the custom
integrations provided by Cloud Elements.
It’s natural for us to support cooperative
endpoints.
Our sense that industry-wide, less than
15% of endpoints actually support
discovery.
20. #SoAI18
@CloudElements
ID or “primary key”.
Name Property. Required.
Nullable string
Related Object by ID (which object?)
Required. Must be number between
0 and 100, no decimal places.
Simple /Contact object, right?
23. #SoAI18
@CloudElements
Request: How do I deliver APIs to support
reactive user experiences, processes, behaviors
and device interactions?
MobileWeb IoT
Business
Processes Microservices
Response: Make your APIs work for these
scenarios by using event-driven patterns that
alleviate constraints of REST
29. #SoAI18
@CloudElements
IN SUMMARY...
- Integration doesn’t need to suck
- Customers & Developers expect
more from your API!
- API Design Considerations
- Auth & API Security
- Docs & Metadata
- Event-Driven Integration
30. #SoAI18
@CloudElements
ROSS GARRETT .
VP Marketing
Cloud Elements
@gssor
RAPHA BARBO
Developer Experience Manager
Cloud Elements
@raphael_barbo
Q & A !
TIME FOR
Yet getting APIs to work is a far greater problem than simple “connecting”
And it’s connecting that you’ll many vendors talking about.
We’re heading towards an apocalypse of scale.
Support some metadata discovery -- not quite as comprehensive.
This is just a really simple example of the same system represents the SAME data, in very different ways.
Web applications are just the beginning - HTTP is now being used across all kinds of applications, platforms and devices.
So ask an obvious question
Get an obvious answer!
As you can see - REST APIs are common to all, but there are many eventing technologies in use,
Facebooks offers Webhooks to developers, while AMQP & HTTP