Dokumentacja API

Szybki start

1. Utwórz klucz w panelu: smart-copy.ai/developers (zaznacz „
   ”, jeśli chcesz budować integrację bez kosztów — pełna walidacja, symulowane odpowiedzi).
2. Adres bazowy: https://www.smart-copy.ai/api/v1
3. Autoryzacja nagłówkiem: Authorization: Bearer sc_live_...

# Zamów tekst 8000 znaków z obrazem
curl -X POST "https://www.smart-copy.ai/api/v1/texts" \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"topic": "Jak działa pompa ciepła", "length": 8000, "language": "pl"}'

# Śledź status (queued → researching → outlining → writing → generating_image → completed)
curl "https://www.smart-copy.ai/api/v1/texts/TEXT_ID" \
  -H "Authorization: Bearer sc_live_..."

W panelu (zakładka API) znajdziesz też interaktywną konsolę z koszykiem żądań, generatorem kodu (cURL / Node.js / Python / PHP) i historią wywołań.

Uwierzytelnianie

• Limit: 120 żądań/min na token (HTTP 429 + nagłówek Retry-After).
• Idempotencja: dodaj nagłówek Idempotency-Key do POST /texts — powtórzone żądanie z tym samym kluczem zwróci zapisaną odpowiedź bez ponownego pobrania środków.
• Waluta rozliczeń: PLN (kurs USD w /balance ma charakter poglądowy).

Teksty

POST/v1/texts

Zamawia wygenerowanie tekstu. Cena naliczana degresywnie za 1000 znaków: 1,99 zł do 5 000 znaków, 1,19 zł za znaki 5 001–15 000, 0,69 zł powyżej — z sufitem 29 zł za tekst; pobierana z salda przy złożeniu (dokładną kwotę zwraca POST /v1/estimate). Batch: zamiast pojedynczego obiektu wyślij pole texts z tablicą (max 500) — jedno zamówienie, wspólna płatność. Opisy produktów (text_type PRODUCT_DESCRIPTION) zamawiane razem w jednym żądaniu mają rabat ilościowy: od 25 −25%, od 100 −45%, od 500 −60% (odpowiedź zwraca bulk_discount).

Odpowiedź 201:
{
  "id": "d92dfaf2-...",
  "object": "text",
  "order_id": "f4a286ea-...",
  "status": "queued",
  "topic": "...",
  "length": 8000,
  "price": 31.92,
  "currency": "PLN",
  "revisions_used": 0,
  "revisions_limit": 3,
  "created_at": "2026-08-10T12:00:00.000Z"
}

GET/v1/texts/:id

Status i wynik. Statusy: queued, researching, outlining, awaiting_outline_approval, writing (z polem section {current, total}), generating_image, completed, failed (środki zwrócone automatycznie). Po ukończeniu odpowiedź zawiera html, featured_image {url, alt} i wp_publications.

GET/v1/texts

Lista tekstów. Parametry: limit (1–100, domyślnie 20), created_before (kursor czasowy z pola next_created_before), wp_site_id (filtr per witryna). Odpowiedź: { "object": "list", "data": [...], "has_more": bool, "next_created_before": "..." } — pole next_created_before pojawia się tylko, gdy has_more = true.

POST/v1/texts/:id/revision

Bezpłatna poprawka ukończonego tekstu. Body: {"feedback": "co poprawić (10–5000 znaków)"} . Limit 3 rewizje/tekst (403 revision_limit_reached po wyczerpaniu). Po ukończeniu rewizji wysyłamy webhook text.completed z revised: true.

POST/v1/estimate

Wycena bez tworzenia zamówienia. Body: {"length": 8000} → cena, strony, saldo i sufficient_balance. Dla paczki opisów produktów dodaj "text_type": "PRODUCT_DESCRIPTION", "quantity": 100 → cena jednostkowa z rabatem, total_price i bulk_discount.

Autoblog

Serie treści: Smart-Copy planuje klaster ~20 tematów (research konkurencji + profil witryny, jeśli dostępny), pisze teksty w zadanym rytmie i publikuje na WordPressie. Każdy tekst rozliczany z salda przed generowaniem; brak środków wstrzymuje serię.

POST/v1/plans

Pozostałe: GET /v1/plans (opcjonalnie ?wp_site_id=), GET /v1/plans/:id (z listą pozycji i statusami), POST /v1/plans/:id/pause i POST /v1/plans/:id/resume. Statusy serii: planning, active, paused, completed.

Saldo i witryny

GET/v1/balance

{
  "object": "balance",
  "balance": 776.56,
  "currency": "PLN",
  "usd_rate": 3.7324,
  "balance_usd": 208.06,
  "auto_topup_enabled": false
}

GET/v1/wp-sites

Witryny WordPress podłączone do konta: id, name, base_url, auth_type (connector | app-password), verified, last_poll_at (żywy sygnał połączenia wtyczki).

Webhooki

Skonfiguruj adres webhooka przy kluczu API (panel → API) albo przy aplikacji OAuth. Zdarzenia: text.completed (także po rewizji, z revised: true), text.failed (z refunded: true — środki wróciły na saldo), outline.ready. Dostawa: POST JSON, retry z wykładniczym odstępem do 5 prób.

POST twoj-adres
X-SmartCopy-Event: text.completed
X-SmartCopy-Signature: sha256=3f5c9a...

{
  "event": "text.completed",
  "created": "2026-08-10T12:34:56.000Z",
  "data": {
    "text": {
      "id": "d92dfaf2-...",
      "topic": "...",
      "progress": "completed",
      "price": 31.92,
      "html": "<h1>...</h1>...",
      "featured_image": { "url": "https://...", "alt": "..." }
    }
  }
}

Weryfikacja podpisu (HMAC-SHA256 sekretu whsec_ z surowego body):

const crypto = require("crypto");
const expected = "sha256=" +
  crypto.createHmac("sha256", process.env.WEBHOOK_SECRET)
        .update(rawBody).digest("hex");
const valid = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers["x-smartcopy-signature"] || ""));

OAuth 2.0

Buduj aplikacje działające na kontach użytkowników Smart-Copy (integracje SaaS, Make.com, Zapier, panele agencji). Przepływ: authorization code + PKCE (S256). Aplikację rejestrujesz w panelu → API → „
” (publiczna z PKCE albo poufna z sekretem).

Zakresy (scopes): texts:read, texts:write (zamówienia płatne z salda użytkownika), balance:read, wp:read, plans:read, plans:write. Użytkownik widzi i cofa dostęp w panelu („
”).

Błędy

{ "error": "insufficient_balance", "error_description": "..." }

Pytania? support@smart-copy.ai