Skip to main content

SD Times Open-Source Project of the Week: GitHub’s OpenAPI Description

This week’s highlighted open-source project of the week is GitHub’s OpenAPI description for its REST API. The company open sourced the description earlier this week.

The OpenAPI specification is a standard for describing the interface of HTTP APIs, allowing both humans and machines to understand what an API does without having to read the documentation or have knowledge of the implementation, GitHub explained.

The description contains over 600 operations that are exposed in GitHub’s API. The description can be used to generate mock servers, test suites, and bindings for languages that aren’t supported by Octokit, which is a collection of official clients for the API.

It is currently provided in two formats: bundled and dereferenced. The bundled version of the description is the preferred one because it uses OpenAPI components for reuse and readability. The dereferenced version is intended only for tooling that has poor support for inline references to components, GitHub explained.

The description is currently in beta. The company plans on doing quarterly releases of it for GitHub Enterprise Server and GitHub Private Instances, and more frequent updates for GitHub.com.

“We expect to make the description even more complete and accurate as we go forward and as OpenAPI becomes central to our developer experience — internally and externally,” Marc-Andre Giroux, senior platform engineer at GitHub, wrote in a post. 

The post SD Times Open-Source Project of the Week: GitHub’s OpenAPI Description appeared first on SD Times.



from SD Times https://ift.tt/3hR5rh2
Labels:

Comments

Post a Comment

Popular posts from this blog

A guide to data integration tools

CData Software is a leader in data access and connectivity solutions. It specializes in the development of data drivers and data access technologies for real-time access to online or on-premise applications, databases and web APIs. The company is focused on bringing data connectivity capabilities natively into tools organizations already use. It also features ETL/ELT solutions, enterprise connectors, and data visualization. Matillion ’s data transformation software empowers customers to extract data from a wide number of sources, load it into their chosen cloud data warehouse (CDW) and transform that data from its siloed source state, into analytics-ready insights – prepared for advanced analytics, machine learning, and artificial intelligence use cases. Only Matillion is purpose-built for Snowflake, Amazon Redshift, Google BigQuery, and Microsoft Azure, enabling businesses to achieve new levels of simplicity, speed, scale, and savings. Trusted by companies of all sizes to meet...
1 comment
Read more

Olive and NTT DATA Join Forces to Accelerate the Global Development and Deployment of AI Solutions

U.S.A., March 14, 2021 — Olive , the automation company creating the Internet of Healthcare, today announced an alliance with NTT DATA , a global digital business and IT services leader. The collaboration will fast track the creation of new healthcare solutions to transform the health experience for humans — both in the traditional healthcare setting and at home. As a member of Olive’s Deploy, Develop and Distribute Partnership Programs , NTT DATA is leveraging Olive’s open platform to innovate, build and distribute solutions to Olive’s customers, which include some of the country’s largest health providers. Olive and NTT DATA will co-develop new Loops — applications that work on Olive’s platform to provide humans real-time intelligence — and new machine learning and robotic process automation (RPA) models. NTT DATA and Olive will devote an early focus to enabling efficiencies in supply chain and IT, with other disciplines to follow. “This is an exciting period of growth at Olive, so...
Post a Comment
Read more

2022: The year of hybrid work

Remote work was once considered a luxury to many, but in 2020, it became a necessity for a large portion of the workforce, as the scary and unknown COVID-19 virus sickened and even took the lives of so many people around the world.  Some workers were able to thrive in a remote setting, while others felt isolated and struggled to keep up a balance between their work and home lives. Last year saw the availability of life-saving vaccines, so companies were able to start having the conversation about what to do next. Should they keep everyone remote? Should they go back to working in the office full time? Or should they do something in between? Enter hybrid work, which offers a mix of the two. A Fall 2021 study conducted by Google revealed that over 75% of survey respondents expect hybrid work to become a standard practice within their organization within the next three years.  Thus, two years after the world abruptly shifted to widespread adoption of remote work, we are dec...
Post a Comment
Read more