This blog post describes the new Cadl API design language and its benefits for API authoring.
Guidelines for multi-tenant applications to validate tenant ownership of user-provided URIs for Azure resources.
Guidelines for applications to validate user-provided URIs for Azure Key Vault or Managed HSM to avoid a potential risk of leaking authentication information.
Developers hate waiting, but sometimes it's necessary. When we know something is going to take time in Azure, it's modeled as a long-running operation (LRO). We've recently updated our guidance on LROs in our REST API guidelines.
Providing APIs that are easy to use, fit to purpose, scalable, maintainable, and consistent make the difference between success and failure for your software. The guidelines help Microsoft engineering teams, and others building REST services, create APIs that are approachable, sustainable, and consistent.
