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

Comments

Popular posts from this blog

Difference between Web Designer and Web Developer Neeraj Mishra The Crazy Programmer

Have you ever wondered about the distinctions between web developers’ and web designers’ duties and obligations? You’re not alone! Many people have trouble distinguishing between these two. Although they collaborate to publish new websites on the internet, web developers and web designers play very different roles. To put these job possibilities into perspective, consider the construction of a house. To create a vision for the house, including the visual components, the space planning and layout, the materials, and the overall appearance and sense of the space, you need an architect. That said, to translate an idea into a building, you need construction professionals to take those architectural drawings and put them into practice. Image Source In a similar vein, web development and design work together to create websites. Let’s examine the major responsibilities and distinctions between web developers and web designers. Let’s get going, shall we? What Does a Web Designer Do?...

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...

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...