Over a million developers have joined DZone.

The Burden on API Providers When it Comes to Web Literacy

I fully support API providers educating their developer around the web technologies in use. However I feel like it shouldn't be a burden on them.

· Integration Zone

Is iPaaS solving the right problems? Not knowing the fundamental difference between iPaaS and dPaaS could cost you down the road. Brought to you in partnership with Liaison Technologies.

I am working through the USGS water data services, which include some REST APIs, and investing some of my work hours to one of my passions and concerns —water data and APIs. There is a wealth of water data available via the federal government web services, and as I'm making my way through the materials, I'm reminded of the heavy burden on API providers when it comes to web literacy. 

The USGS water services APIs documentation are about 30% education about common web concepts and specifications like gzip, CORS, ISO-8601 Duration format, SO-8601 Date format, what is JavaScript Object Notation (JSON), and much more.

I see this approach often with API efforts that offer both REST and SOAP services, where the education of developers around key web concepts is much more necessary, but it also depends on how much the API providers actually care about their developers being literate — I guess USGS cares more than many other more commercial providers.

I fully support API providers educating their developer around the web technologies in use. However I feel like it shouldn't be a burden on them, and they should have a wealth of resources available to plug in and do the work for them, so they can spend their time making their APIs better. This is why I'm working with Erik Wilde (@dret) to make his important showcase of essential web concepts and specification as machine readable and as accessible as possible so that we can get to work making more resources available to API providers when it comes to web literacy.

Ideally, web literacy is default amongst developers, but until that is a reality, we should be assisting all API providers in educating their API consumers within their developer portals, and in line with their existing documentation. Ideally, we should be doing this in a more structured approach, and begin evolving Eriks' work into a kind of forkable, embeddable, plug and play curriculum that API providers like the USGS can put to work with as little effort as possible.

Discover the unprecedented possibilities and challenges, created by today’s fast paced data climate and why your current integration solution is not enough, brought to you in partnership with Liaison Technologies.

Topics:
apis ,government ,api

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

Opinions expressed by DZone contributors are their own.

The best of DZone straight to your inbox.

SEE AN EXAMPLE
Please provide a valid email address.

Thanks for subscribing!

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

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

{{ parent.tldr }}

{{ parent.urlSource.name }}