JavaScript SDK

npm install @one-career/sdk

import { OneCareer, OneCareerError } from "@one-career/sdk";

const oc = new OneCareer({
  apiKey: process.env.ONE_CAREER_API_KEY, // omit for public endpoints only
  maxRetries: 2,                          // 429 always; 5xx/network for GET & DELETE
  timeoutMs: 30_000,
});

// one page
const page = await oc.postings.list({ status: "open", limit: 50 });
page.data; page.has_more; page.next_cursor;

// everything (fetches pages of 100 lazily)
for await (const app of oc.applications.all({ posting_id })) { … }

// any list endpoint
for await (const iv of oc.paginate((cursor) => oc.interviews.list({ cursor }))) { … }

try {
  await oc.applications.move(id, "offer");
} catch (e) {
  if (e instanceof OneCareerError) {
    e.code;       // "insufficient_scope" | "not_found" | "rate_limited" | …
    e.status;     // HTTP status (0 for network errors)
    e.requestId;  // quote this to support
    e.retryAfter; // seconds, for 429
  }
}

import { verifyWebhook, signTestPayload } from "@one-career/sdk/webhooks";

const event = await verifyWebhook({ payload: rawBody, header: req.headers["oc-signature"], secret: process.env.OC_WEBHOOK_SECRET });

// in your tests
const header = await signTestPayload("whsec_test", JSON.stringify({ id: "1", type: "ping", created_at: new Date().toISOString(), data: {} }));