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.
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)
}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/sdkEdge runtime uyumlu, RSC + server actions dostu, full type-safe.
$ pnpm add @karum/sdkimport { 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
Asynckarumasync / await native, Pydantic modeller, FastAPI + Django ile uyumlu.
$ pip install karumfrom 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
Stablekarum/php-sdkPHP 8.2+ desteği, Laravel + Symfony adapter'ları, PSR-18 HTTP istemci.
$ composer require karum/php-sdkuse 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;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.
İ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ış.