Fork me on GitHub

API Evangelist Blog

JCI & Panoptix Internal Evangelism: Selling Not Just The API, But The Overall Approach Internally

Posted on

I just had a great conversion with John Bernd (@jkbernd) and Simone Vigano (@viganosimone) of Johnson Controls (JCI), who lead efforts at the building efficiency API, Panoptix. They shared several great stories with me, I’ll trickle out over the next week, with the first one about internal evangelism. Internal evangelism, whether your API is public or private, is something I’ve advocated for pretty heavily over the last few years. Lack of internal evangelism around an API can be the number on reason you get your API defunded within any size organization. Basically if the rest of the company, included your......read more.



An API Design Discussion With API Blueprint, RAML And Swagger Creators

Posted on

REST head Glenn Block (@gblock) over at Splunk asked a simple question on Twitter Wednesday night, Who is using Swagger? I responded, kicking off a conversation that a day later included Tony Tam (@fehguy) of Swagger, Uri Sarid (@usarid) of RAML, and Jakub Nesetril (@jakubnesetril) of API Blueprint. After the fact, the conversation may be a little unwieldy to follow, but it contains enough insight and nuggets of information, I feel its worth publishing and hopefully continuing in other formats. The conversation began on Twitter: [View the story "API Design" on Storify] Then we moved to jabbr.net to stop blasting......read more.



What Are The Common Building Blocks of API Integration?

Posted on

I started API Evangelist in 2010 to help business leaders better understand not just the technical, but specifically the business of APIs, helping them be successful in their own API efforts. As part of these efforts I track on what I consider the building blocks of API management. In 2014 I'm also researching what the building blocks are in other areas of the API world, including API design, deployment, discovery and integration. After taking a quick glance at the fast growing world of API integration tools and services, I've found the following building blocks emerging: Pain Point Monitoring Documentation Monitoring -......read more.



API Design: Do You Swagger, Blueprint or RAML?

Posted on

I’m spending the next couple weeks going through each of the leading API design approaches: API Blueprint, RAML and Swagger. Even though I still personally use Swagger in my own work, I’m pushing myself to learn API Blueprint and RAML to better understand the landscape, as well as the pros and cons of each approach. If you aren’t familiar with this emerging trends in API design, they are approaches to defining your APIs either using JSON or a markdown language, which allows you to quantify and describe the API interfaces and underlying data models in a way that allows you......read more.



Take Another Look At The Thingiverse 3D Printing Community API

Posted on

Have you taken a look at the Thingiverse developer area lately? It’s been a while since I reviewed it. A couple years ago while working at Mimeo as an API evangelist I had the pleasure of doing some deep research into not just printing APIs, but 3D printing APIs as well. I wrote a lot on the subject, but overall I was unhappy with what was available in the areas of 3D printing APIs. When you go to the Thingiverse API now, the landing page immediately tells you what is possible, gives you direct links to API documention, but also provides......read more.



API Strategy & Practice Call For Papers Ends This Week

Posted on

The call for papers is ending this week for API & Strategy & Practice conference, March 26th,27th and 28th, in Amsterdam. So far we have over 25 talks submitted, with numerous slots already taken by sessions, panels and keynotes we already have scheduled. If you want to get your talk considered you need to submit by this Friday. By this weekend we will be closing the call for papers, reviewing and making decisions on the talks we feel should be part of the #APIStrat lineup. If you are looking for advice on how to craft your talk for success, read......read more.



What Happened With Federal Agencies And Their Data.json Files

Posted on

I’m playing catchup on some of my projects, and one of them is tracking on the evolution of Executive Order 13642 from last May, which was the White House directive to make open and machine readable the new default for government information. The piece that I'm tracking on specifically right now is around the OMB Memorandum M-13-13 Open Data Policy-Managing Information as an Asset, in which one of the items require agencies to publish a data.json file that provides a machine readable inventory of each agencies public data assets. In short, each federal agencies should round up a list of......read more.



Caching APIs With CloudFormations Or OpenShift

Posted on

During the recent federal government shutdown this last fall, the concept of API redundancy became much more important for me, and I hope for others as well. The need to ensure public open data and APIs, as well as private sector resources, stay available is becoming increasingly vital. As I work through these thoughts I'm playing with different approaches to caching some types of APIs. In my experimentation, I'm using AWS CloudFormation and RedHat OpenShift to deploy caches of commonly used APIs resources. Each type of API deployment is designed to sync with the mothership upon activation, and then receive regular......read more.



Submitting A Talk For #APIStrat in Amsterdam

Posted on

I had a friend ask me for help with their talk submission for #APIStrat in Amsterdam. He was concerned that his talk was too product pitchy, and wanted help making it something that not just would be accepted by our event, but something community would want to hear. It is good to hear the concern, its true we want the best talks at #APIStrat, we don’t want to have a bunch of product pitches, we are seeking stories of API strategy and the practices from the trenches of API design, deployment and management. Additionally, the audience doesn't want to hear......read more.



Experimentation And Iteration Is Good, But Share The Exhaust From Your API Research Ericsson

Posted on

Ericsson once had around 19 APIs available via their Ericsson Labs platform. After doing a round of looking through all the APIs I track on, I noticed they have ALL gone away. They are still doing a lot of research, but they seem to have lost their interest in APIs all together. I have no problem with experimentation and playing around with different resources, and even the deprecation of APIs, with appropriate communication, when it makes sense. I know Ericsson exploration is via their labs, and isn't really meant for production, but it grinds on me when there are APIs......read more.