Документация API

SDK

Официальные клиенты для интеграции с КЗ24 API

JS

@24cz/api

JavaScript / TypeScript. Node 18+, Bun, Deno, browsers.

v1.0.0 готов к использованию
Типизированные ошибки (KZBalanceError, KZRateLimitError, …)
HMAC verifyWebhookSignature() helper
Auto Idempotency-Key для POST/PATCH
Auto retries с exponential backoff
Установка:
npm install @24cz/api
Quick start:
import { KZClient } from '@24cz/api'

const kz = new KZClient({ apiKey: process.env.KZ_API_KEY! })

const me = await kz.me.get()
console.log(`Баланс: ${me.balance_rub} ₽, тариф: ${me.tier.name}`)

await kz.factories.create({
  name: 'Цветы Москва',
  factory_category: 'seller',
  product_name: 'Букеты',
})
GitHubTry в Explorer
Py

kz24

Python 3.10+, async/sync, типизация через TypedDict

в разработке

Не нашёл свой язык? Используй curl/OpenAPI

Можно сгенерировать клиент для любого языка из спеки OpenAPI 3.1:

# OpenAPI Generator (Go, Java, Rust, PHP, Ruby, etc)
npx @openapitools/openapi-generator-cli generate \
  -i https://test.24contentzavod.ru/api/v1/openapi.json \
  -g go -o ./kz24-go-client