wyro

SDKs

Dois clientes oficiais, sem dependências em tempo de execução: @wyroapi/sdk (Node.js 18+, TypeScript, ESM e CommonJS) e 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"])

O que incluem

  • Posts: criar, consultar, listar (com paginação por next_cursor ou um iterador), reagendar, cancelar e bulk(csv, { dryRun }) para um CSV. Fila: consultar, definir e próximos horários livres. Chaves limitadas: criar, listar e revogar.
  • Contas: listar e desconectar. Conectar: o link para conectar uma conta real.
  • Métricas: posts.metrics(id), accounts.metrics(id, período) e analytics.overview(período).
  • Mídia: envio direto (até 4 MB) e um helper para o envio pré-assinado de arquivos maiores.
  • Webhooks: definir, consultar, remover e verifySignature(secret, timestamp, body, signature).
  • Parceiros: criar, listar, consultar e remover workspaces de clientes, girar a chave e forClient(externalId) para agir por um cliente com o seu token de parceiro:
const client = wyro.forClient("client-123"); // partner token + X-Wyro-External-Id
await client.posts.create({ text: "…", platforms: ["linkedin"] });
  • Erros como uma exceção tipada (WyroError) com code, message, fix, status e details (catálogo).
  • Novas tentativas em 429 e 5xx, respeitando o Retry-After (limites); criações só são repetidas quando você passa um idempotencyKey (idempotência).

Verificar um webhook

import { verifySignature } from "@wyroapi/sdk";

const ok = verifySignature(secret, req.headers["x-wyro-timestamp"], rawBody, req.headers["x-wyro-signature"]);