Ask HN: Which API IDLs would you use?

This page summarizes the projects mentioned and recommended in the original post on

Our great sponsors
  • InfluxDB - Access the most powerful time series database as a service
  • SonarLint - Clean code begins in your IDE with SonarLint
  • SaaSHub - Software Alternatives and Reviews
  • vocab-idl

    Help and clarify how JSON Schema can be interpreted from validation rules to data definition. This extends to how those data definitions can be represented in any programming language

    The state of competing standard problem seems to be here to stay so I have to pick one.

    CADL from Microsoft:

    Smithy from Amazon:

    JSON Schema IDL vocab (not a thing yet, and doesn't sound promising at all):

    And I know there are many IDL, but I only pick the ones based on their API related work.

    OpenAPI's JSON Schema is definitely not designed for data modeling that's why the generator is a mess.


    I'm personally inclined to Smithy which seems to be the most battle-tested with real and large use case. And there's a better chance to convince my boss "it's from AWS", and generating OpenAPI file from it is also aligned with "standard" vibe.

  • cue

    The home of the CUE language! Validate and define text-based and dynamic configuration

  • InfluxDB

    Access the most powerful time series database as a service. Ingest, store, & analyze all types of time series data in a fully-managed, purpose-built database. Keep data forever with low-cost storage and superior data compression.

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts