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

Hazards of Developers Evangelist for an API

DZone's Guide to

Hazards of Developers Evangelist for an API

· 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.

I’m working to make it easier to get up and running using the Mimeo Connect Cloud Print API.

One concept that is tough to understand at first, is that all printing starts with a Mimeo document.

Then using the API you can either order that document as is, or merge one or many PDF documents with it, generate a dynamic document, then order this new document.

As part of our API, we have a Document Listing Service, except it only pulls documents from a central account I have control of.

So if you want to pull one of the documents you created, you have to actually pull the Document ID from your My Mimeo account.

Sounds easy right? Well its available in the URL, and in a properties screen for the document.

The Document ID is a GUID, for those of you who don’t know what a GUID is:

A globally unique identifier or GUID (pronounced /ˈɡuːɪd/ or /ˈɡwɪd/) is a unique reference number used as an identifier in computer software

So a Document ID looks like this:

3F2504E0-4F89-11D3-9A0C-0305E82C3301

Except for some reason the one that shows in My Mimeo is missing the dashes, and doesn’t work when you pass through the API.

So I ask my API developer, where is the easiest place to get the Document ID?

He says, “In the URL or as property of document”.

I explain it doesn’t work without dashes.

His response is, “Developers will understand, and know to put dashes back in”.

And that is a hazard of putting developers as the public face of your API.

They make a lot of assumptions based upon what they know.

API Evangelists and developer advocates should definitely have programming skills, but ideally they should have a balance of proramming, business and marketing skills.

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:

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 }}