Developers

SDKs & artifacts

The developer kit: TypeScript and C# SDKs, the Postman collection, and the governed OpenAPI contract.

The developer kit

Itemra publishes a versioned developer kit generated from the governed OpenAPI contract, containing the TypeScript package (@itemra/customer-api), the .NET package (Itemra.CustomerApi), a Postman collection grouped by resource, the OpenAPI JSON itself, and a changelog — with SHA256SUMS to verify every asset before installing.

TypeScript

import { Configuration, ItemsApi } from '@itemra/customer-api'

const items = new ItemsApi(new Configuration({
  basePath: 'https://api.itemra.io',
  accessToken: process.env.ITEMRA_API_KEY,
}))

const result = await items.v1ItemsGet({ limit: 10, sort: 'name' })

Server-side runtimes only — an API key in a browser bundle is a compromised key.

C#

using Itemra.CustomerApi.Api;

var items = host.Services.GetRequiredService<IItemsApi>();
var response = await items.V1ItemsGetAsync();

The package wires bearer auth and typed clients through the standard .NET host builder; see the kit's quickstart for the full setup.

Postman and OpenAPI

Import the collection, point its baseUrl at https://api.itemra.io, and keep the bearer token in a private environment — never in an exported collection. Anything the SDKs don't cover is one generation away: the contract at api.itemra.io/openapi/v1.json is the same file the kit is built from, and Scalar renders it interactively.