Skip to content
ITEMRA
Documentation menu

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.

Download the developer kit from the public release repository; no application-repository access is needed. Choose a version and download the ZIP or individual packages. Compare each download's SHA-256 with the matching line in the release's SHA256SUMS. The ZIP also retains the original kit manifest and internal checksums. Packages are installed from the downloaded files, not from npmjs.org or nuget.org.

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.