İçeriğe geç
Tüm sistemler çalışıyor — %99.997 uptime
Geliştiriciler · SDK

3 dilde resmî SDK.

TypeScript-first tasarım, OpenAPI'den otomatik üretilen tipler. Python + PHP ile aynı API yüzeyi, aynı garantiler. İlk isteğine dakikalar içinde varırsın.

TypeScriptPythonPHP
index.ts
import { Karum } from "@karum/sdk"

const karum = new Karum({
  apiKey: process.env.KARUM_KEY!,
  env: "production",
})

const { items, nextCursor } = await karum.products.list({
  filter: { inStock: true, status: "ACTIVE" },
  limit: 50,
})

for (const product of items) {
  console.log(product.title, product.price)
}
Resmî SDK'lar

Dilini seç, yüklemeden başla.

Her SDK aynı endpoint kapsamını kapsar, aynı sürüm numarasıyla yayınlanır. Yeni endpoint API'ye eklendiği gün üç dilde de mevcut olur.

TypeScript / Node.js

Önerilen
@karum/sdk

Edge runtime uyumlu, RSC + server actions dostu, full type-safe.

$ pnpm add @karum/sdk
import { Karum } from "@karum/sdk"

const karum = new Karum({
  apiKey: process.env.KARUM_KEY!,
  env: "production",
})

const { items, nextCursor } = await karum.products.list({
  filter: { inStock: true, status: "ACTIVE" },
  limit: 50,
})

for (const product of items) {
  console.log(product.title, product.price)
}

Python

Async
karum

async / await native, Pydantic modeller, FastAPI + Django ile uyumlu.

$ pip install karum
from karum import Karum

karum = Karum(api_key=os.environ["KARUM_KEY"])

orders = await karum.orders.list(
    status="paid",
    created_after="2026-05-01",
    limit=100,
)

for order in orders.items:
    print(order.id, order.total, order.currency)

PHP

Stable
karum/php-sdk

PHP 8.2+ desteği, Laravel + Symfony adapter'ları, PSR-18 HTTP istemci.

$ composer require karum/php-sdk
use Karum\Client;
use Karum\Inventory\AdjustRequest;

$client = new Client(getenv("KARUM_KEY"));

$result = $client->inventory()->adjust(new AdjustRequest(
    sku: "TSHIRT-M-BLACK",
    delta: -1,
    reason: "order:ord_3Axx",
));

echo $result->newQuantity;
SDK garantileri

Her SDK aynı kalite çıtasından geçer.

Tam tip güvenliği

OpenAPI 3.1 şemasından otomatik üretilir — derleyici hatası, IDE auto-complete, runtime sürpriz yok.

Akıllı retry

Ağ ve 5xx için exponential backoff, idempotency-key otomatik. Çift charge endişesi yok.

Observability

Her istek request-id header'ı taşır, OpenTelemetry span'leri Sentry / Datadog'a otomatik düşer.

Semantik sürümleme

Breaking change yalnızca major sürümde. Minor + patch geriye dönük uyumlu.

Başlangıç

İlk satışınız bu hafta. Kurulum 5 dakika.

Karum kurulum ekibi süreci yönetir. Veri taşıma, ürün eşleme ve kanal bağlama dahil — ortalama 3–7 günde ilk satış.

BAŞLAYALIM