by David I | Aug 9, 2017 | APIs, Cloud Computing, DevRelate, Programming |
When a developer’s app is built using one or more remote services and a problem occurs, users will start reporting a problem. Users will not necessarily know what is causing the problem. It could be issues with a cloud based service’s API, a cloud storage system or a bug in the software. How can your app know what the problem? Developer programs that provides services and APIs should also provide a live, frequently updated status page. Providing status APIs and pages allows the software, developers, partners, ISVs and even end users to track down problems. Ultimately the solution to any problem is the responsibility of the app developer (and company) regardless of where the fault is. Well designed and implemented developer programs should provide an API to check status and receive notifications for apps to fail-over, recover, fail gracefully and display problem information and solutions to users.

Developer System Status Pages
Here are a few developer program system status pages that I’ve found in my research and assessments. Some sites also provide APIs, feeds and subscriptions to program and API status information.
Status Page Hosting and API services
Altassian, for example, provides to customers a status page hosting service and API. You can find details of the developer service at https://www.statuspage.io/. Here is a list of some of the companies that use the hosting and API service:
3rd Party Status Check Sites
There are several 3rd party status check sites that monitor popular sites and provide an edit box to input a URL. You can use these services to see if another site/service is up or down. Some, like DownDetector, provide APIs (for a fee) to check on service status.
Do you provide a service status page and status API as part of your developer program?
If you have your developer service status and API, send me an email with additional information and the links to the status page and API.

David Intersimone “David I”
Vice President of Developer Communities
Evans Data Corporation
davidi@evansdata.com
Blog: https://www.devrelate.com/blog/
Skype: davidi99
Twitter: @davidi99
LinkedIn: https://www.linkedin.com/in/davidi99/
by David I | May 30, 2017 | APIs, DevRelate, Webinar |
This week, I am presenting a DevRelate webinar, “Developer Relations and your Company’s APIs” on Wednesday (May 31) and Thursday (June 1). This blog post contains additional information and links covered in the webinar.
APIs and Your Company
Developer Relations and APIs
API Documentation Examples
API Versioning – Overview
REST
- URI
- Request parameter
- Media type (aka content negotiation & accept header)
- Date
- Custom request header
- Domain name
SOAP
- XML namespaces and XML comments
- UDDI version aware service registry
Shared Code Files
- Filename
- Version resource
API Resource Links
API Documentation Generation Tools
Additional Swagger Resources
The following Swagger related links were provided by SmartBear Software (thank you Keshav and Tracy)
- [Blog] API Design Best Practices – https://swaggerhub.com/blog/api-design/api-design-best-practices/
- [Blog] What is API Design, and Why it Matters – https://swaggerhub.com/blog/api-design/what-is-api-design/
- [Webinar] Scaling your API Design Process – https://swaggerhub.com/blog/api-design/scaling-your-api-design/
- [eBook] Optimizing the Swagger collaborative workflow using SwaggerHub – https://swaggerhub.com/blog/api-resources/optimize-your-swagger-api-workflow/
- [Blog] Design first or Code first approach to APIs – https://swaggerhub.com/blog/api-design/design-first-or-code-first-api-development/
- [Webinar] API Developer Experience (DX), and good documentation practices for good DX – https://swaggerhub.com/blog/api-documentation/api-documentation-and-developer-experience/
API Versioning – Examples
Facebook / Parse (BaaS) API Shutdown Example
Evans Data Developer Program Workshops and Assessments
If you have additional API links, best practices, tools, tips, tricks, thoughts and questions, send me an email.

David Intersimone “David I”
Vice President of Developer Communities
Evans Data Corporation
davidi@evansdata.com
Blog: https://www.devrelate.com/blog/
Skype: davidi99
Twitter: @davidi99
LinkedIn: https://www.linkedin.com/in/davidi99/
by David I | Apr 13, 2017 | Developer Outreach, Developer Programs News, Developer Relations, DevRelate |
During one of the Evans Data 13th Annual Developer Relations Conference Sunday Boot Camp sessions on Best Practices (featuring developer programs and features from boot camp attendees), three specific developer program sites were called out by several of the attendees. In addition, we also had the opportunity to have two of our Boot Camp faculty members on hand to talk more about their developer programs, sites and features.
Ford Developer Program
Scott Burnell, Ford Motor Company Global Lead, Business Development & Partner Management, spent a few minutes talking about the Ford Developer Program and took questions from the attendees. Scott covered several of the Ford developer program offerings including:
- SYNC® AppLink™ – AppLink is a suite of APIs that provide the ability for mobile developers to extend the command and control of a mobile application to the in-vehicle Human Machine Interface (HMI).

- Smart Device Link (SDL) – an open-source POSIX-compliant technology platform on which the Ford AppLink product is built and allows it to communicate between applications running on a mobile device and our SYNC in-vehicle software.
- https://developer.ford.com/pages/sdl
- POSIX-compliant technology platform
- Deploy to Linux, QNX, or other popular embedded operating systems
- Communicate with any mobile device OS such as iOS or Android.
- OpenXC – a non-production open source interface, designed to attract top developers to experiment with DIY projects in Ford vehicles (with or without SYNC).

Ford TDK
ThingWorx Developer Program
Michael Aglietti, VP of Developer Programs at ThingWorx, got up next and spent a few minutes going over the ThingWorx developer program, specific aspects that are unique to an IoT company and took questions from the attendees. Michael covered some of the ThingWorx offerings including:
- “Begin Your IoT Journey”
- Program is focused to help developers:
- Make – ThingWorx allows you to connect anything and everything including devices, sensors, and systems. By leveraging the power of the platform, you can quickly build impactful solutions.
- Analyze – You do not have to be a data scientist to produce insights as if you were one. Leverage our platform to derive meaningful insights from your data.
- Code – Use the ThingWorx development tools and API’s to quickly connect devices and build secure applications. Leverage existing systems and device clouds for ultimate flexibility.

- REST APIs – Quick starts, How To’s, Cheat Sheets
- SDKs for Java, .NET, C, iOS, Android
- Edge Micro Server (EMS) – Raspberry Pi
- Marketplace – The ThingWorx Marketplace gives you easy access to everything you need to build and run your ThingWorx based IoT application: From extensions and apps that can be downloaded and integrated directly into your ThingWorx application to partners that can help you build your IoT solution or offer certified and compatible products that work with it.

Three Developer Programs attendees said had great Documentation Best Practices
Several of the boot camp attendees mentioned the following three developer programs saying they had great documentation for developers.

Thank You AngelHack, Boot Camp Faculty, Product Marketing Panelists and Attendees
A big thanks to AngelHack for sponsoring this year’s Evans Data Developer Relations Boot Camp. Two big thank you(s) to Scott (from Ford) and Michael (from ThingWorx). And finally, massive thank you(s) to all of our great boot camp attendees for your participation and your feedback surveys. With your help we will continue to evolve the boot camp day to meet your needs. I hope we see you again next year!

David Intersimone “David I”
Vice President of Developer Communities
Evans Data Corporation
davidi@evansdata.com
Blog: https://www.devrelate.com/blog/
Skype: davidi99
Twitter: @davidi99
LinkedIn: https://www.linkedin.com/in/davidi99/