WoodSystems Developers

SDKs

Official SDKs are coming. Until then, generate a client from the OpenAPI file or import it into Postman.

Official WoodSystems SDKs are coming. Until they are published, the OpenAPI file describes every endpoint, field, error and webhook payload, and any OpenAPI 3.1 generator can turn it into a typed client for your language.

Generate a client

Download the file, then run the generator you prefer. For example, for TypeScript and Python:

curl -o openapi.v1.json https://developers.woodsystems.com/openapi.v1.json

npx @hey-api/openapi-ts -i openapi.v1.json -o src/woodsystems

pipx run openapi-python-client generate --path openapi.v1.json

Things to set up in whatever you generate:

  • The base URL: https://api.woodsystems.com, or https://api-sandbox.woodsystems.com for the sandbox.
  • Authentication: X-Api-Key and X-Tenant-Id on every request, or Authorization: Bearer <key>.
  • An Idempotency-Key header on every POST, unique per submission and reused when you retry.
  • Money fields are decimal strings. Keep them as strings or a decimal type, never a float.
  • New optional fields can appear in /v1 at any time, so configure the client to ignore fields it does not know.

Postman

In Postman, choose Import, then paste the link https://developers.woodsystems.com/openapi.v1.json or pick the downloaded file. Postman builds a collection with every endpoint. Set the X-Api-Key and X-Tenant-Id headers, or a bearer token, on the collection so every request carries them.