azure-rest-api-specs
SOFA
azure-rest-api-specs | SOFA | |
---|---|---|
7 | 2 | |
2,466 | 1,045 | |
1.7% | - | |
10.0 | 8.7 | |
3 days ago | 2 days ago | |
TypeScript | TypeScript | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
azure-rest-api-specs
-
Shared APIM Service
Agree here. When I was on the API Management team, I generally saw customers set up a repository of API specifications (incidentally, this is also how we do it internally at Microsoft - check it out at https://github.com/azure/azure-rest-api-specs) - those specifications generally drive the API Management side of things, but with review from a centralized API management team. The “spec” should consist of both the specification (Swagger, SOAP, GraphQL SDL, etc.) and the policy or policies appropriate for the API.
- Are subscriptions idempotent when deployed via Bicep? I seem to have some issue with them after having success the first time.
-
StackQL provider for Azure is now available
The StackQL Azure provider was created using the Autorest project using Azure specification docs from the azure-rest-api-specs repository. We will be adding integrated interactive authentication; for now, this is cli/sdk based; you can find all the documentation here.
-
LocalStack 1.0 General Availability
In the spirit of moto, it actually looks like quite a bit of the groundwork is available for someone to take a swing at an Azure version:
* the cli uses the python SDK: https://github.com/Azure/azure-cli/blob/azure-cli-2.38.0/src...
* which uses autorest: https://github.com/Azure/azure-sdk-for-python/tree/azure-mgm...
* of what appears to be an OpenAPI-ish spec: https://github.com/Azure/azure-rest-api-specs/tree/fda2db441...
-
Implementing Microsoft REST API Guidelines Filter
I'm not sure what you mean by "it is very hard to give contextuality on it"; OAS does supports referring to a type by reference, so that higher level types can reuse the definition of structs they might contain.
But even so, here the problem is that the APIs aren't actual PUT/GETs: they payload types aren't the same going up as they are coming down. It is really two separate types, one for PUT, one for GET.
Some of that is to be expected (there will be some information after the create that is only added by the VM coming into being) but how Kubernetes handles this with a separate "status" for the item I think ends up letting the rest of the type (spec, in k8s's case) be the same type. (… ish. K8s has variants of this problem, too.)
To expand a bit, I'm largely relegated to the API docs themselves. Browsing the actual schema is hard:
Start at: https://github.com/Azure/azure-rest-api-specs
-
Azure Bicep - How do I know what property values are valid?
I feel your pain, a good resource for me has been the REST API specs - https://github.com/Azure/azure-rest-api-specs/tree/master/specification
-
apiVersion deprecation
You might get some clues here. Maybe. https://github.com/Azure/azure-rest-api-specs
SOFA
- Expose async-graphql schema as REST endpoints?
-
Sofa — The best way to REST (is GraphQL)
So we created Sofa (pun intended), an open source library you install on your GraphQL server to create a fully RESTful and configurable API gateway. Use GraphQL to REST.
What are some alternatives?
prism - Turn any OpenAPI2/3 and Postman Collection file into an API server with mocking, transformations and validations.
loopback-next - LoopBack makes it easy to build modern API applications that require complex integrations.
mockoon - Mockoon is the easiest and quickest way to run mock APIs locally. No remote deployment, no account required, open source.
autorest - OpenAPI (f.k.a Swagger) Specification code generator. Supports C#, PowerShell, Go, Java, Node.js, TypeScript, Python
graphql-mesh - The Graph of Everything - Federated architecture for any API service
azure-cli - Azure Command-Line Interface
fern - 🌿 Stripe-level SDKs and Docs for your API
stackql-provider-registry - Registry for cloud and SaaS providers for StackQL, generated from extensions to the providers OpenAPI3 specification
swagger-typescript-api - TypeScript API generator via Swagger scheme
azure-sdk-for-python - This repository is for active development of the Azure SDK for Python. For consumers of the SDK we recommend visiting our public developer docs at https://docs.microsoft.com/python/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-python.