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

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?
Post a Comment
Read more

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
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 declaring 20
Post a Comment
Read more