Intro

All our APIs follow the open API specification version 3 (OSA3). That gives us (and you) the option to generate code

OpenAPI Specification

Generators

There are several OSA3 generators. This one supports almost all languages you can think of:

Hello from OpenAPI Generator

TypeScript / JavaScript Generator

Are you a web developer, then the simplest would be to generate code using the openapi JavaScript or TypeScript generator:

openapi-typescript-codegen

Check out our tutorial here: [TypeScript projects with Handy API v2](https://ohdoki.notion.site/TypeScript-projects-with-ada7e21322f2472bbf84ca2c211f465d)

Steps

Add the code generator to our project

npm install -D openapi-typescript-codegen

Add the relevant import code

You will find the relevant import script command located in the documentation for each of the APIs.

Add the the script command under your scripts in your package.json file. Example for Handy API v2 :

"importApi": "openapi --exportSchemas true --input <https://www.handyfeeling.com/api/handy/v2/spec> --output _HANDYAPI --name HandyApi",