Smithy IDL

The Smithy Interface Definition Language (IDL) is a specification for defining API models using shapes and traits. Models can be written in the Smithy IDL syntax or the JSON AST representation. Smithy 2.0 is the current stable version with improved nullability, enums, resource properties, and mixins.

API entry from apis.yml

apis.yml Raw ↑
aid: smithy:smithy-idl
name: Smithy IDL
description: The Smithy Interface Definition Language (IDL) is a specification for defining API models
  using shapes and traits. Models can be written in the Smithy IDL syntax or the JSON AST representation.
  Smithy 2.0 is the current stable version with improved nullability, enums, resource properties, and
  mixins.
humanURL: https://smithy.io/2.0/
tags:
- IDL
- API Design
- Specification
properties:
- type: Documentation
  url: https://smithy.io/2.0/
- type: Specification
  url: https://smithy.io/2.0/spec/
- type: Getting Started
  url: https://smithy.io/2.0/quickstart.html
- type: GitHub Repository
  url: https://github.com/smithy-lang/smithy