ZeroTierOne API Spec

OpenAPI and JSON-schema for the ZeroTierOne service API.

This is the API that lets you leave and join networks on your local machine, or configure a self-hosted network controller.

The specs are generated from a typespec spec.

dev

npm install 
npm start

Open http://localhost:8080

test

This integration test requires zerotier-one to be running. It may change configuration of your node! It runs in github actions too.

AUTH_TOKEN=$(cat /path/to/authtoken.secret) npm test

If you have a pre-release version of zerotier-one try:

ENABLE_UNSTABLE=1 npm t

missing features

Features not implemented by typespec yet

• openapi examples
• tag descriptions

publishing

How to create a github release.

Releases contain the openapi and json-schema files.

Try to use conventional commit messages if you want. They will appear in the changelog.

• Go to the Actions Tab
• Click Release on the left
• Click Run Workflow on the right
• Type in the appropriate version (patch)
• Click run

The url to the latest release of the openapi spec is: https://github.com/zerotier/zerotier-one-api-spec/releases/latest/download/openapi.yaml