Efni

SkjölunFyrir forritara

Pakkar og tól

Pakkar Kling fyrir forritara á Íslandi. @klingis/sdk fyrir þjóninn, @klingis/embed fyrir vafrann og @klingis/mcp fyrir gervigreindarfulltrúa.

Kling er með þrjá npm-pakka fyrir kóðann þinn, og @klingis/cli tengir verkefni við Kling úr skipanalínunni. Þeir virka allir strax með prófunarlykli.

Pakki Hvað hann er
@klingis/sdk SDK með týpum fyrir Kling API, búið til úr OpenAPI-lýsingunni
@klingis/embed Greiðsluglugginn: greiðslusíða ofan á þinni síðu
@klingis/mcp MCP-þjónn fyrir gervigreindarfulltrúa, líka hýstur á https://api.kling.is/mcp

@klingis/sdk

bash
npm install @klingis/sdk
typescript
import { configure, postV1CheckoutSessions } from "@klingis/sdk";

configure({
  baseUrl: "https://api.kling.is",
  headers: {
    Authorization: `Bearer ${process.env.KLING_SECRET_KEY}`,
    "Content-Type": "application/json", // nauðsynlegt, sjá að neðan
  },
});

const res = await postV1CheckoutSessions(
  {
    amount: 5000, // 5.000 kr.
    currency: "ISK",
    success_url: "https://example.is/takk",
  },
  { headers: { "Idempotency-Key": "pontun-1042" } },
);

if (res.status === 200) console.log(res.data.id, res.data.url);

Haltu Content-Type hausnum í configure. SDK-ið sendir hann ekki sjálft enn, og án hans hunsar API-ið meginmál beiðnarinnar: greiðsluferli mistekst með 400, PATCH breytir engu og hlutaendurgreiðsla (amount) endurgreiðir alla upphæðina.

Föllin heita eftir aðferð og slóð: POST /v1/checkout/sessions er postV1CheckoutSessions, GET /v1/customers/{id} er getV1CustomersById. Hvert þeirra skilar { data, status, headers }. 200 frá postV1PaymentIntents getur samt verið hafnað kort: athugaðu res.data.status (sjá Hafnaðar greiðslur). SDK-ið notar fetch og keyrir í Bun og í þjónakóða sem fer í gegnum bundler (Next.js, Remix, SvelteKit, Vite). Í hreinu Node ESM án bundler skaltu kalla beint á REST API-ið með fetch.

@klingis/embed

bash
npm install @klingis/embed

Eða <script src="https://api.kling.is/v1/kling.js"></script>. Sjá Greiðslugluggi.

@klingis/mcp

Leyfir gervigreindarfulltrúum eins og Claude, ChatGPT og Cursor að vinna með Kling aðganginn þinn: búa til greiðsluferli, greiðsluhlekki, vörur og viðskiptavini, og lesa greiðslur, áskriftir og skýrslur. Kling hýsir hann á https://api.kling.is/mcp, með API-lykil frá Kling sendan sem bearer-tóka; pakkinn keyrir sama þjón á þinni eigin vél. Í stjórnborðinu er spjaldið Connect AI assistants á síðunni API lyklar og skjölun með tilbúna slóð fyrir Claude og ChatGPT.

Skoða sem markdown