azure-rest-api-specs is a free, open source api development & testing project written in TypeSpec and released under MIT. It has 3,093 GitHub stars, 5,958 forks and 3,379 open issues, and was last pushed 57 minutes ago. On this registry it ranks #81 of 154 tracked projects in API Development & Testing, with 5 head-to-head comparisons available.

Azure REST API Specifications

Description

This repository is the canonical source for REST API specifications for Microsoft Azure. You can learn more about it here.

Getting started

If you're a Microsoft employee looking for information about all of the repositories and steps for Azure SDK Libraries Releases, go to the aka.ms/azsdk/join.

External Contributors can read Getting Started with OpenAPI Specifications and Getting Started with TypeSpec Specifications.

Directory Structure

See aka.ms/azsdk/spec-dirs.

Examples

These examples provide a starting point for how a library should be structured, as well as the expected options that libraries should use:

Next steps

The next step in the process after a spec is completed is to generate SDKs and API reference documentation. If you're a Microsoft employee, go to the Azure SDK - Internal Wiki for more information.

External Contributors can read Getting Started with OpenAPI Specifications and Getting Started with TypeSpec Specifications.


This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Frequently asked questions

Is azure-rest-api-specs free to use?

azure-rest-api-specs is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does azure-rest-api-specs do?

The source for REST API specifications for Microsoft Azure.

What is azure-rest-api-specs written in?

azure-rest-api-specs is primarily written in TypeSpec. Its source is publicly available at https://github.com/Azure/azure-rest-api-specs, and it has 3,093 GitHub stars.