SDKs
Dos clientes oficiales, sin dependencias en tiempo de ejecución: @wyroapi/sdk (Node.js 18+, TypeScript, ESM y CommonJS) y wyro (Python 3.9+).
npm install @wyroapi/sdk
pip install wyro
Node.js / TypeScript
import { Wyro } from "@wyroapi/sdk";
const wyro = new Wyro({ apiKey: process.env.WYRO_API_KEY });
const post = await wyro.posts.create(
{ text: "…", platforms: ["instagram"], media: [{ url: "https://…/a.jpg" }] },
{ idempotencyKey: crypto.randomUUID() },
);
console.log(post.status, post.preview_url);
for await (const p of wyro.posts.iterate()) console.log(p.id, p.status);
Python
import os, uuid
from wyro import Wyro
wyro = Wyro(api_key=os.environ["WYRO_API_KEY"])
post = wyro.posts.create(
{"text": "…", "platforms": ["instagram"], "media": [{"url": "https://…/a.jpg"}]},
idempotency_key=str(uuid.uuid4()),
)
print(post["status"], post["preview_url"])
for p in wyro.posts.iterate():
print(p["id"], p["status"])
Qué incluyen
- Posts: crear, consultar, listar (con paginación por
next_cursoro un iterador), reprogramar, cancelar ybulk(csv, { dryRun })para un CSV. Cola: consultar, configurar y próximos horarios libres. Claves limitadas: crear, listar y revocar. - Cuentas: listar y desconectar. Conectar: el link para conectar una cuenta real.
- Métricas:
posts.metrics(id),accounts.metrics(id, rango)yanalytics.overview(rango). - Medios: subida directa (hasta 4 MB) y un helper para la subida prefirmada de archivos más grandes.
- Webhooks: configurar, consultar, borrar y
verifySignature(secret, timestamp, body, signature). - Partners: crear, listar, consultar y borrar espacios de clientes, rotar su clave y
forClient(externalId)para actuar por un cliente con tu token de partner:
const client = wyro.forClient("client-123"); // partner token + X-Wyro-External-Id
await client.posts.create({ text: "…", platforms: ["linkedin"] });
- Errores como una excepción tipada (
WyroError) concode,message,fix,statusydetails(catálogo). - Reintentos ante
429y5xx, respetandoRetry-After(límites); las creaciones solo se reintentan si pasas unidempotencyKey(idempotencia).
Verificar un webhook
import { verifySignature } from "@wyroapi/sdk";
const ok = verifySignature(secret, req.headers["x-wyro-timestamp"], rawBody, req.headers["x-wyro-signature"]);