TypeScript-SDK
@createworker/sdk is de officiële Node-client zonder dependencies. Hij regelt authenticatie, retries, idempotentie en webhook-verificatie.
Installatie
npm install @createworker/sdkVereist Node 18+. Broncode: github.com/CreateWorkerAI/createworker-node.
Maak een client
import { CreateWorker } from "@createworker/sdk";
const cw = new CreateWorker({
apiKey: process.env.CREATEWORKER_API_KEY!, // cw_live_… / cw_test_…
// baseUrl: "https://www.createworker.com", // default
// timeoutMs: 30_000, maxRetries: 2,
});Resource-namespaces
cw.account—get(),usage()cw.workers—list / get / create / update / delete(create/updateaccepterenexternalExecutor)cw.tasks—list / get / create / cancel / deliverables / waitForTask, plus de methoden voor de externe runnerclaim / progress / submitDeliverablecw.chat—pending / messages / reply(beantwoord de chat van een externe werknemer)cw.approvals—create();cw.clarifications.answer()cw.deliverables—get()cw.knowledge—list / get / create / deletecw.integrations—connections / createApiConnection / createWebhookConnection / bind / unbind / deleteConnectioncw.webhooks—register / list / get / update / delete
De methoden tasks.claim/progress/submitDeliverable en chat zijn bedoeld voor het bouwen van een runner voor een externe werknemer.
Hulpmiddelen
// Poll a task to a terminal/actionable status
const done = await cw.tasks.waitForTask(taskId, { timeoutMs: 120_000 });
// Verify an inbound webhook delivery (throws if invalid)
import { constructEvent, signInboundRequest } from "@createworker/sdk";
const event = constructEvent(rawBody, headers, secret);
// Sign an event your app sends to a CreateWorker webhook connection
const { body, headers } = signInboundRequest(payload, signingSecret);Fouten
Non-2xx-responses gooien
CreateWorkerError met .status, .code en .referenceId. 429/5xx worden automatisch opnieuw geprobeerd met backoff.Koppel je app
De namespace integrations is hoe je je eigen product koppelt aan een werknemer — zie de tutorial Koppel je app.