Posted on 06-10-2014
I’m still extracting great examples of API design, deployment, and management, that other API providers can follow, from recent API projects out of our federal government, with FBOpen from 18F, and OpenFDA out of the Food & Drug Administration (FDA).
This particular post is about the approach to establishing a feedback loop with consumers of the OpenFDA API. If you visit the OpenFDA portal, you will find that API consumers can seek help via three self-service channels:
If you don’t get your question answered by searching through existing Github, StackExchange, and Twitter conversations, you have three ways to directly ask the OpenFDA team questions:
What is notable (thanks Gray Brooks), is that OpenFDA uses existing services to establish the feedback loop with API consumers—meaning they use Github, StackExchange, and Twitter rather than rolling their own tool. OpenFDA understands that there are existing conversation that are already occurring on StackExchange, and developers are used to going here to find the answers they need.
Additionally by stimulating the conversation on StackExchange and Twitter you are generating valuable social media and SEO exhaust that will help new consumers, potentially learn about the OpenFDA API, and how it is being used by developers. This type of feedback loop doesn’t just provide support for community, it establishes itself as the heartbeat of your API, showing that someone is home, and is there to support and listen.
The best part is that using Twitter, StackExchange, and Github are free for public conversations, and take almost no time to setup. OpenFDA directly links to the form for asking a question on StackExchange, they don’t for Github, but easily could. They also directly link to #OpenFDA hashtag to join existing conversations on StackExchange and Twitter, which is a pretty slick way to weave external searches into your API feedback loop.
Lots of good patterns to follow, from the leading groups deploying APIs in the US federal government.
comments powered by Disqus
Winning in the API Economy
|Download as PDF|
Latest Blog Posts
- On Being An API Broker For Hackathons
- Are You A Hypermedia Pragmatist?
- Do You Know That Hypermedia Is A Better Solution For Discovery Than APIs.json?
- API Service Idea: API Via Excel From Within Corporate Email
- With Number Of APIs Continuing To Grow Account Automation Will Be Key
- History Of APIs: NOAA APIs Have Been RESTful For Over 20 Years
- Understanding More About The Web Communications Platform Respoke
- Swagger Definition Driven Sandbox And Simulation Data Templates For APIs
- Swagger API Definition Mapper
- Moving Beyond Just The PDF With A Single Page Report (SPR)