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
npm install @klingis/sdkimport { 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
npm install @klingis/embedEð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.