API · v1

API

Jeden endpoint. Pošlete POST se svým souborem, dostanete zpět vyčištěný. Stejný engine, který pohání naši aplikaci — běží na Vercelu, rate-limit per klíč, nikdy neuchovává váš obsah.

GAVyžaduje tarif Plus50 000 požadavků / 30 dnů

Autentizace

Každý požadavek musí obsahovat Bearer token v hlavičce Authorization. Klíče generujte na /app/settings. Klíč se zobrazí jen jednou při vytvoření — uložte ho do správce tajemství a podle potřeby rotujte.

Přístup k API vyžaduje tarif Plus.

curl https://exifsweep.com/api/v1/clean \
  -H "Authorization: Bearer ms_live_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  --output photo-cleaned.jpg

POST /api/v1/clean

Odešlete soubor jako surové tělo požadavku. V odpovědi obdržíte bajty vyčištěného souboru.

Požadavek

Hlavička	Hodnota
Authorization	Bearer ms_live_…
Content-Type	image/* · video/* · application/pdf · application/zip

Odpověď 200

Hlavička	Popis
Content-Type	Odpovídá vstupu
X-ExifSweep-Mode	`image-strip` nebo `video-strip`
X-ExifSweep-Duration-Ms	Čas zpracování na serveru

Tělo: bajty vyčištěného souboru.

Příklady

curl https://exifsweep.com/api/v1/clean \
  -H "Authorization: Bearer $EXIFSWEEP_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @input.jpg \
  --output output.jpg

Limity

Tarif Plus zahrnuje 50 000 požadavků v klouzavém 30denním okně na jeden API klíč. Při překročení API vrátí 429 s hlavičkou X-RateLimit-Reset, která ukazuje na čas dalšího resetu (unix ms).

Potřebujete víc? Napište na [email protected] — nabízíme i vlastní enterprise limity.

Chybové kódy

Stav	kód	Kdy
400	empty_body	V požadavku nejsou žádné bajty
401	unauthorized	Chybí Bearer hlavička
401	invalid_token	Klíč neznámý nebo zneplatněný
402	upgrade_required	Klíč patří k jinému než Plus tarifu
413	file_too_large	Překračuje limit vašeho tarifu na soubor
415	unsupported_format	Kontrola magických bajtů selhala
415	unsupported_content_type	Content-Type mimo povolený seznam
429	rate_limited	Měsíční kvóta vyčerpána
500	internal	Chyba serveru — prosím opakujte

Všechny chybové odpovědi jsou JSON: { "error": { "code": "...", "message": "..." } }

Doporučené postupy

· Streamujte soubory místo načítání do paměti — jak váš, tak náš kód je streaming-friendly.
· Opakujte jen u 500 s exponenciálním backoffem. Ostatní 4xx kódy jsou deterministické chyby.
· Pokud pošlete stejný vstup v krátkém okně dvakrát, cache si držte sami — my za vás necachujeme.
· Klíče držte ve správci tajemství (Vault, AWS Secrets, GitHub Secrets). Nikdy je nekomitujte.
· Při změně v týmu klíče rotujte. Endpoint pro odvolání má okamžitý účinek.

Vyzkoušejte

Pošlete reálný API požadavek se svým klíčem. Nemáte ho? Vygenerujte v nastavení.

Potřebujete vyšší limity nebo vlastní SLA?

Nabízíme enterprise tarify — ozvěte se nám.

Kontaktujte nás Ceník