Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Focusing on a Single Example of What an API Is When Onboarding Folks

DZone's Guide to

Focusing on a Single Example of What an API Is When Onboarding Folks

We should be dialing in our storytelling so that we can increase the number of folks who understand that they can take control over their own information.

· Integration Zone
Free Resource

Modernize your application architectures with microservices and APIs with best practices from this free virtual summit series. Brought to you in partnership with CA Technologies.

Talking to people and telling stories on a regular basis always pushes me to evolve my understanding of how people see (or don't see) APIs to keep shifting the way I tell stories. I've always felt that that education about APIs should be relevant to the users, but usually this centers around making it familiar and speaking to whoever I am helping onboard. After talking to some folks recently at APIStrat, I'm adding to my thinking on this, and focusing on making my stories more precise for folks I talk with.

One of the reasons I really like APIs is that they are so versatile. You can take a piece of data or content or an algorithm (code), and wrap with an API, and provide read and write access via the Internet. However, I think the average person does not thrive in this environment and needs an explanation that is more precise. It doesn't help them to know that APIs can do anything; they need it to be relevant, but also to provide a single solution that they can wrap their heads around, and apply in their world.

I am just sharing this thinking as I'm working to add it to my storytelling toolbox. I'm really committed to helping people understand what APIs are, so they can help push back on platforms to have APIs, as well as be more open with existing APIs. It doesn't do any good to confuse people with an unlimited number of API scenarios. We should be dialing in our storytelling so that we can help onboard them with the concept and increase the number of folks who understand that they can take control over their own information on the platforms they depend on each day.

The Integration Zone is proudly sponsored by CA Technologies. Learn from expert microservices and API presentations at the Modernizing Application Architectures Virtual Summit Series.

Topics:
apis ,integration ,onboarding

Published at DZone with permission of Kin Lane, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

THE DZONE NEWSLETTER

Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

X

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}