SDKs

Official SDKs wrap REST auth, retries, idempotency, and webhook verification. Until packages are published on public registries, use the in-repo client or HTTP + OpenAPI.

Planned packages

Language	Package	Install (target)
JavaScript / TypeScript	@ioneshop/sdk	npm install @ioneshop/sdk
Python	ioneshop	pip install ioneshop
PHP	ioneshop/sdk	composer require ioneshop/sdk
Java	eu.ioneshop:sdk	Maven / Gradle
C#	IoneShop.Sdk	dotnet add package IoneShop.Sdk

Status: Partial — minimal JS client in packages/sdk (@ioneshop/sdk). Public npm publish still roadmap. Track changelog.md.

JavaScript usage (in-repo client)

import { IoneShopClient } from "@ioneshop/sdk";

const client = new IoneShopClient({
  apiKey: process.env.IONESHOP_API_KEY!,
  baseUrl: "https://sandbox-api.ioneshop.cloud",
});

const page = await client.listProducts({ limit: 50 });
for (const p of page.data) {
  console.log(p.id, p.title);
}

for await (const p of client.paginateProducts({ limit: 100 })) {
  // walks pagination.next_cursor
}

Python (contract example)

# pip install ioneshop  (not published yet)
from ioneshop import Client

client = Client(api_key="isk_test_…", base_url="https://sandbox-api.ioneshop.cloud")
for product in client.products.list(limit=50):
    print(product["id"])

Prefer the hosted OpenAPI (/openapi.yaml) until language SDKs ship.