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
- Request parameter
- Media type (aka content negotiation & accept header)
- Custom request header
- Domain name
- XML namespaces and XML comments
- UDDI version aware service registry
Shared Code Files
- 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
In today’s interconnected world, companies in all industries need to publish APIs and cultivate a developer community to access and use them. To be competitive today, attracting and supporting developers is essential. The key to cultivating a vibrant developer community that uses your APIs and supports your platform is a good developer relations program. “Developer Programs and APIs in the News” is a series of news items from developer programs around the world.
Developer Programs and APIs in the News
Google – January 31 – Google IO developer conference – May 17-19, 2017. Shoreline Amphitheatre, Mountain View, CA – “Check back soon for more details.”
VoiceLabs – January 30 – VoiceLabs releases 4 new SDKs for Amazon Alexa and Google Assistant – “We’re excited to roll out new VoiceLabs SDKs to support the entire ecosystem of voice developers. For Alexa: In addition to Node.js, Java and Python, you’ll find a new Ruby SDK and a modified Python SDK to support the Flask-ask platform. For Assistant: In addition to Node.js, there is now a Java SDK and a Python SDK.”
Microsoft – January 30 – Announcing .NET Core, .NET Native and NuGet Updates in VS 2017 RC – “We just released updates to the .NET Core SDK, .NET Native Tools and NuGet, all of which are included in Visual Studio 2017 RC. You can also install the .NET Core SDK for command-line use, on Windows, Mac and Linux.”
Amazon – January 30 – Excited about MXNet joining Apache! – “We have a significant team at Amazon working with the MXNet community to continue to evolve it. The team proposed MXNet joining the Apache Incubator to take advantage of the Apache Software Foundation’s process, stewardship, outreach, and community events. We’re excited to announce that it has been accepted.”
Facebook – January 30 – parse.com is now shut down – “The Parse service is now shut down. To all the developers out there, it was a pleasure helping you build apps. Goodbye and good luck!”
Node.js Foundation – January 26 – The Node.js Foundation Partners with The Linux Foundation on New Node.js Certification Program – “The Node.js Foundation, a community-led and industry-backed consortium to advance the development of the Node.js platform, today announced development of the inaugural Node.js certification program aimed to establish a baseline competency in Node.js.”
Cisco – January 25 – Cisco Announces Intent to Acquire Application Performance Monitoring Leader AppDynamics – “AppDynamics’s cloud application and business monitoring platform enables the world’s largest companies to improve application and business performance. The combination of Cisco and AppDynamics will allow us to provide end to end visibility and intelligence from the network through to the application; which, combined with security and scale, and will help IT to drive a new level of business results.”
Apple – January 24 – Allow Users to Provide Ratings From Within Your App – “With iOS 10.3 developers can use a new API to ask users to provide store ratings from within the app.”
Qlik – January 24 – Qlik Sense Cloud Business Now Available for Immediate Web-based Visual Analytics – “Powered by the patented QIX Associative Indexing Engine, Qlik Sense Cloud Business provides the scalability and performance of the industry-proven Qlik visual analytics platform in a complete cloud environment.”
Intel – January 24 – ZTE Achieves Performance Breakthrough for Deep Learning with Intel FPGAs – “Intel and ZTE, a leading technology telecommunications equipment and systems company, have worked together to reach a new benchmark in deep learning and convolutional neural networks (CNN). The technology is what many companies in Internet search and artificial intelligence are trying to advance, and includes picture search and matching, as one example.”
Microsoft – January 23 – Microsoft makes testing easy with open source Visual Studio Test – “Microsoft has open sourced its Visual Studio Test aka VS Test platform. The latest open source project by the software giant was originally used by its internal team to run tests in various languages. Available as a part of the .Net Core Tools in Visual Studio, VS Test is popularly used for integrated testing with Visual Studio. ”
Qt Company – January 23 – Qt v5.8 is released – “I am happy to announce that Qt 5.8 has been released today and is available for download from qt.io. Qt 5.8 does of course come with Qt Creator 4.2.1 and an update to Qt for Device Creation. Qt 5.8 is a rather large release, containing quite a large set of new functionality.”
Oracle – January 19 – Oracle acquires Apiary – “Oracle today announced that it has signed an agreement to acquire Apiary, whose pioneering APIFlow solution provides the framework and tools for developing application programming interfaces (APIs) that share enterprise services and data and help create modern, cloud-based applications and experiences.”
Google – January 18 – Welcoming Fabric to Google – “Today, we’re excited to announce that we’ve signed an agreement to acquire Fabric to continue the great work that Twitter put into the platform. Fabric will join Google’s Developer Product Group, working with the Firebase team. Our missions align closely: help developers build better apps and grow their business.”
VoiceLabs – January 15 – The 2017 Voice Report by VoiceLabs – “In 2016, Amazon Echo evolved from novelty to in-the-home powerhouse, with over seven million devices in households. Google Home launched in November, legitimizing a multi-platform ecosystem of voice-first devices. VoiceLabs created The Voice Report to help define this emerging market, map out key pieces of the ecosystem, and highlight both the impressive growth and areas for improvement.” The VoiceLabs 36-page 2017 Voice Report highlights key analysis and predictions for voice first devices and based applications.
Visa – January 12 – Meet Visa Developer’s Community Manager Ricardo Navarro – “Meet Ricardo Navarro! He joined Visa as our new Visa Developer Community Manager. As Community Manager, he’ll be engaged in supporting and inspiring developers to become more familiar trying out the APIs connected with this new innovative platform.” This post has a Q&A with Ricardo so you get to know him better.
Google – January 6 – The Google+ API for Hangouts is no longer supported. – “We will be retiring the Google+ Hangouts API that enables developers to build apps for the older version of Hangouts video calls. New apps cannot be created but existing apps will continue to run until April 25th, 2017. We have carefully considered this change and believe that the latest updates allow us to give our users a more targeted Hangouts desktop video experience going forward.”
Sony – January 4 – Sony’s new LMX-001 display allows companies to fully customize their AR solutions – “With the LMX-001 holographic waveguide display, companies can develop customized augmented reality (AR) solutions tailored for specific use cases. The waveguide display can be integrated into a range of products such as protective eyewear, motorcycle helmets, lab glasses and any other type of solutions where the user benefits from getting real-time information directly in the field of view.”
Send me your Developer Programs News!
If you have news about your Developer Relations Program, send me an email about the news.
David Intersimone “David I”
Vice President of Developer Communities
Evans Data Corporation