Browse docs
OpenAPI 3.1 social media API SDK: what's available today#
Generating a client from the spec#
Import the OpenAPI document into Postman or Insomnia to explore the API interactively, or point any standard OpenAPI code generator (openapi-generator, openapi-typescript, kiota) at it to produce a typed client in Python, Go, Java, or any other supported language. Because the spec covers the security schemes too, most generators wire up the Bearer auth header automatically.
bash
openapi-generator-cli generate \
-i https://skedcast.com/openapi.json \
-g python \
-o ./skedcast-clientThe TypeScript SDK#
@skedcast/sdk is a typed, fetch-based client — the same one the SkedCast console itself runs on. It's first-party today (not yet on npm); build against the REST API or the generated client in the meantime, and switch to the published package once it ships.
ts
import { createSkedcast } from "@skedcast/sdk";
const sk = createSkedcast({
baseUrl: "https://api.skedcast.com/v1",
apiKey: process.env.SKEDCAST_API_KEY,
});
const { data } = await sk.posts.create({ clientId, content, targets, schedule });openapisdkcodegen
FAQ
- Is the OpenAPI spec kept in sync with the real API?
- Yes — it's the machine-readable version of the same /v1 surface documented at /developers/api-reference. Import it into Postman, Insomnia, or a codegen tool for a client that matches the live API.
- When will @skedcast/sdk be published to npm?
- It's currently a first-party package used internally by SkedCast's own apps. A public npm release is planned; build against the REST API or a generated OpenAPI client until then.