Convertica API

Dlaczego Convertica API

Szybki start

1. Wygeneruj klucz w panelu

Przejdź do panelu kluczy API i utwórz nazwany klucz. Pełny klucz jest wyświetlany jednorazowo — skopiuj go natychmiast.

2. Wykonaj zapytanie

Przykład curl — konwertuj PDF na Word:

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -o output.docx

Przykład w Pythonie

import requests
r = requests.post(
    "https://convertica.net/api/v1/pdf-to-word/",
    headers={"Authorization": "Bearer cvk_live_xxxxxxxxxxxxxxxx"},
    files={"pdf_file": open("input.pdf", "rb")},
)
with open("output.docx", "wb") as f:
    f.write(r.content)

Przykład w Node.js

import fs from "node:fs";
import { request } from "undici";
const form = new FormData();
form.set("pdf_file", new Blob([fs.readFileSync("input.pdf")]), "input.pdf");
const r = await request("https://convertica.net/api/v1/pdf-to-word/", {
  method: "POST",
  headers: { Authorization: "Bearer cvk_live_xxxxxxxxxxxxxxxx" },
  body: form,
});
fs.writeFileSync("output.docx", Buffer.from(await r.body.arrayBuffer()));

Uwierzytelnianie

Wyślij swój klucz API jako token Bearer w nagłówku Authorization. Klucze są powiązane z Twoją subskrypcją — możesz je cofnąć i zmienić w dowolnym momencie z panelu.

• Do 10 aktywnych kluczy na konto, z opcjonalnym zakresem nazwanym
• Prefiks wyświetlany w panelu w celu łatwej identyfikacji (pełny klucz pokazywany tylko przy tworzeniu)
• Miesięczny limit na klucz powiązany z poziomem subskrypcji — licznik resetuje się 1. dnia miesiąca
• Zahaszowane w spoczynku; jeśli klucz wycieknie, cofnij go i wydaj nowy w kilka sekund

Asynchroniczne webhooki

Duże zadania zwracają identyfikator zadania i działają w tle. Możesz odpytywać endpoint zadania lub ustawić URL zwrotny i pozwolić Convertica na przesłanie wyniku.

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "callback_url=https://yourapp.example/convertica-hook"

Ładunki webhooków są podpisywane za pomocą HMAC-SHA256 przy użyciu sekretu wyświetlanego w panelu. Zweryfikuj nagłówek X-Convertica-Signature przed zaufaniem treści.

Limity i ograniczanie szybkości

Co otrzymujesz

• Ponad 30 punktów końcowych konwersji: PDF↔Word, Excel, PPT, JPG, PNG, HTML, EPUB, Markdown
• Edycja PDF: scalanie, dzielenie, obracanie, znak wodny, podpis, kompresja, przycinanie, spłaszczanie
• Obrazy: optymalizacja, konwersja, HEIC→JPG/PNG
• Tryby synchroniczny (małe pliki) i asynchroniczny (duże pliki)
• Opcjonalne wywołania zwrotne webhook z podpisem HMAC dla wyników asynchronicznych
• Dokumentacja OpenAPI 3
• Mediana poniżej 200 ms, węzeł w UE
• Ten sam backend co convertica.net — sprawdzony w boju

Często zadawane pytania