api

api copied to clipboard

Magical SDK generation from an OpenAPI definition 🪄

• Installation
• Usage
  • Authentication
  • Parameters and Payloads
  • HTTP requests
  • Server configurations
• How does it work?
• FAQ

api is a library that facilitates creating an SDK from an OpenAPI definition. You can use its codegen offering to create an opinionated SDK for TypeScript or JS (+ TypeScript types).

$ npx api install https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json

const SDK = require('@api/petstore');

petstore.listPets().then(res => {
  console.log(`My pets name is ${res[0].name}!`);
});

Or you can use it dynamically (though you won't have fancy TypeScript types):

const petstore = require('api')(
  'https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json'
);

petstore.listPets().then(res => {
  console.log(`My pets name is ${res[0].name}!`);
});