@hubcommerce/n11

n11 TR Marketplace API SDK — REST (JSON) + SOAP (XML), task async poll, poll-primary sipariş.

Yalnızca server-side kullanın. N11_APP_KEY / N11_APP_SECRET tarayıcıda, mobil uygulamada veya public repo'da asla bulunmamalı.

• Node >=20.10.0 · ESM-only · sıfır runtime dependency
• N11Result<T> — throw yerine ok / error
• 1.0.0 — 26/26 metod (14 REST + 12 SOAP), task poll, poll-primary sipariş

Detay: docs/CONFORMANCE.md · docs/ADAPTER-CONTRACT.md · docs/OFFICIAL-ANSWERS.md

Kurulum

npm install @hubcommerce/n11

Monorepo yerel:

npm install file:../commerce-packages/marketplace/n11

Yapılandırma

.env.example dosyasını kopyalayın:

copy marketplace\n11\.env.example .env

| Değişken | Açıklama | |----------|----------| | N11_APP_KEY | REST header + SOAP body auth | | N11_APP_SECRET | REST header + SOAP body auth (G1 — kategori CDN dahil) | | N11_INTEGRATOR_NAME | Task body integrator sabiti | | N11_DEBUG | 1 / true — debug log | | N11_ALLOW_PROD_MUTATIONS | 1 — prod mutasyon guard bypass (QA) |

Host: Tek prod https://api.n11.com — sandbox dokümante değil (G5).

Hızlı başlangıç

import { createN11Client } from "@hubcommerce/n11";

const client = createN11Client({
  appKey: process.env.N11_APP_KEY!,
  appSecret: process.env.N11_APP_SECRET!,
  integratorName: "MyIntegrator",
});

const conn = await client.testConnection();
if (conn.ok) {
  console.log("n11 bağlantı OK");
}

Geliştirme

npm run build --workspace=@hubcommerce/n11
npm test --workspace=@hubcommerce/n11
npm run test:exports --workspace=@hubcommerce/n11
npm run check:deps --workspace=@hubcommerce/n11

Lisans

MIT — LICENSE