The document discusses trends and best practices in API design and integration, emphasizing the challenges of integration despite the increasing number of public APIs. It highlights the importance of authentication security, metadata discovery, and the demand for event-driven APIs. The key takeaway is that improving API experiences is essential for meeting customer and developer expectations.

1. #SoAI18
@CloudElements
SUCK LESS
2018 Trends and API Design Best Practices
Making Integration

2. #SoAI18
@CloudElements
ROSS GARRETT .
VP Marketing
Cloud Elements
@gssor
RAPHA BARBO
Developer Experience Manager
Cloud Elements
@raphael_barbo
HELLO
SAY

3. #SoAI18
@CloudElements
HOUSEKEEPING
- Submit your questions
- Slides, recording, will be available
after the webinar
- Start tweeting!
- #SoAI18
- @CloudElements

4. #SoAI18
@CloudElements
Cloud Elements 2017 - Confidential & Proprietary
Integratio
n
Sucks...

5. #SoAI18
@CloudElements
IN A NETWORKED WORLD,
[THE THREE MOST DESIRABLE THINGS ARE]
CONNECTIONS
“
CONNECTIONS
CONNECTIONS
BREAKING SMART, Marc Andreessen & Venkatesh Rao

6. #SoAI18
@CloudElements
CONNECTIONS ARE EASY,
INTEGRATION IS HARD

7. #SoAI18
@CloudElements
Workflows
CONNECTING
TO THE API
Error
Handling
INTEGRATING
WITH THE API

8. #SoAI18
@CloudElements
PROLIFERATION
OF PUBLIC APIs
757% .
Increase in Web APIs
January 2010 - January 2016

9. #SoAI18
@CloudElements
Cloud Elements 2017 - Confidential & Proprietary
APOCALYPSE OF SCALE

10. #SoAI18
@CloudElements
TRENDS
IN APIs
PART 1

11. #SoAI18
@CloudElements
Available
March 29th, 2018!
IN REGARDS TO
API INTEGRATION,
WHAT ARE YOUR
CUSTOMERS &
PARTNERS
DEMANDING?

12. #SoAI18
@CloudElements
WHERE IN API TECHNOLOGY & SERVICES DO YOU SEE GAPS OR
NEED FOR INNOVATION?
Available
March 29th, 2018!

13. #SoAI18
@CloudElements
API SECURITY
& AUTH
PART 2

14. #SoAI18
@CloudElements
AUTHENTICA
TION
POLL QUESTION:
What is your preferred
authentication mechanism for APIs?
● OAUTH1
● OAUTH2
● API Key
● Basic
● Custom

15. #SoAI18
@CloudElements
AUTHENTICA
TION
FACTOR IN SECURITY
OVER 59% .
of APIs are using an
authentication mechanism that is
not OAUTH2.
OAUTH2 is preferred mechanism for
token-based access.

16. #SoAI18
@CloudElements

17. #SoAI18
@CloudElements
DOCUMENTATI
ON
& META
DATA
PART 3

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.

19. #SoAI18
@CloudElements
Dynamics CRM {Contact}
Salesforce CRM {Contact} Dynamics CRM {Contact}

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?

21. #SoAI18
@CloudElements
FOCUS ON THE
DATA YOU CARE ABOUT
YOUR data inside each app is where
all the value lies

22. #SoAI18
@CloudElements
EVENT DRIVEN
APIs
PART 4

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

24. #SoAI18
@CloudElements
Does your application offer webhooks?
● Yes
● No
● What are webhooks?!
WEBHOOKS
POLL QUESTION:

25. #SoAI18
@CloudElements
EIGHTY PERCENT OF DEVELOPERS
PREFER TO USE WEBHOOKS OVER
OTHER METHODS

26. #SoAI18
@CloudElements
yet only
29%
of applications
actually support
webhooks

27. #SoAI18
@CloudElements
And the alternatives aren’t a great
option...

28. #SoAI18
@CloudElements
THERE ARE PLENTY OF EXAMPLES

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

31. #SoAI18
@CloudElements
Coming Soon!
Early access link coming your way!

32. #SoAI18
@CloudElements
THANK YOU
FOR JOINING