SDK Corp-Merch dla Polski
Oficjalne typowane biblioteki klienta dla Node.js, Python i PHP. Automatyczne retry, idempotency, weryfikacja webhooków, wbudowany sandbox.
Co zawierają SDK
Każde SDK zawiera: typowany klient (TypeScript .d.ts / Python type stubs / PHP 8 atrybuty), automatyczne retry z backoffem wykładniczym, generację idempotency-key, helper weryfikacji podpisu webhook, przełącznik sandbox/produkcja, ustrukturyzowane klasy błędów z RFC 7807. Testowane na rzeczywistym katalogu PL przed każdym release.
Komendy instalacji
Node.js: npm install @corp-merch/sdk. Python: pip install corp-merch (Python 3.10+). PHP: composer require corp-merch/sdk (PHP 8.1+). Wszystkie pakiety podpisane; lockfile publikowane. Minor co tydzień; semver-strict — bez breaking changes poza majorami.
Lokalizacja kraju
SDK przyjmują country='Poland' przy inicie i automatycznie: stosują VAT 23%, kierują faktury przez KSeF, domyślny hub Warszawa, formatują walutę dla polskiego locale. Override per-request przez opts.country jeśli potrzeba. Katalog zawiera name_i18n dla angielskiego i polskiego.
FAQ
Który język wybrać?
Ten, którego używa Twój zespół — parytet funkcjonalności. Node.js najpopularniejszy (45%), Python drugi (30%), PHP trzeci (25%).
Czy SDK działa w serverless?
Tak — mały footprint (Node.js ~80 KB), brak natywnych zależności. Testowane na Vercel, AWS Lambda, Cloudflare Workers (z subpakietem @corp-merch/sdk-edge).
Czy jest CLI?
npx @corp-merch/cli dostarczane z Node.js SDK — przydatne do dumpów katalogu, tworzenia zamówień sandbox, inspekcji payloadów webhook.
Jak ustrukturyzowane są błędy?
Wszystkie błędy rozszerzają CorpMerchError z code, message, httpStatus, detailUrl. Subklasy: ValidationError, AuthError, RateLimitError, ServerError, IdempotencyConflictError.
Polityka wersjonowania?
SemVer-strict. Majory roczne z 12-miesięcznym zachodzeniem supportu. Minory miesięczne. Patche bezpieczeństwa backportowane do ostatnich dwóch majorów.