HTTP API

Ověřujte přístup, zjišťujte nástroje a potvrzujte změny přes existující HTTP API.

Požadavky produktového API posílejte na důvěryhodný origin Influence, například https://influence.so. Doména dokumentace produktové požadavky API nepřijímá. Používejte přesné níže uvedené cesty bez parametrů dotazu.

Vytvořte klíč API s omezenými oprávněními

V nastavení Influence otevřete Aplikace a automatizace → Klíče API. Vyberte potřebná oprávnění a dobu platnosti. Klíč zobrazený pouze 1× uložte do úložiště tajných údajů jako PUBLISH_API_TOKEN. Posílejte jej v Authorization: Bearer …; nikdy jej nevkládejte do URL, těla požadavku ani chatu. Jakmile jej nepotřebujete, odvolejte jej.

Zjistěte nástroje a načtěte účty

Nastavte PUBLISH_API_URL na důvěryhodný origin. Příklady předpokládají, že proces už má PUBLISH_API_TOKEN. accountList vyžaduje integrations:read; pro další stránky použijte jeho stránkovací pole.

export PUBLISH_API_URL="https://influence.so"
curl "$PUBLISH_API_URL/api/v1/tools" \
  -H "Authorization: Bearer $PUBLISH_API_TOKEN"

curl "$PUBLISH_API_URL/api/v1/tools/accountList/call" \
  -H "Authorization: Bearer $PUBLISH_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"input":{}}'

Cesty požadavků

Metoda	Cesta	Účel
`GET`	`/api/v1/tools`	Vypíše nástroje dostupné pro tento přístupový údaj.
`POST`	`/api/v1/tools/{tool}/call`	Zavolá nástroj bez nutnosti potvrzení, včetně pokračování autorizovaného nahrávání.
`POST`	`/api/v1/tools/{tool}/prepare`	Připraví přesný zápis, ale neprovede jej.
`POST`	`/api/v1/tools/{tool}/confirm`	Potvrdí připravený zápis.
`POST`	`/api/v1/media/import`	Potvrdí připravené binární nahrání malého obrázku.

Požadavky nástrojů v JSON používají Content-Type: application/json a tělo obsahující pouze input: {"input":{…}}. Schéma vstupu každého nástroje získejte z aktuálního katalogu.

Připravte a potvrďte akce

Řiďte se polem confirmation v katalogu: čtení obvykle potvrzení nepotřebuje, ale aktualizace Statistik je vyžaduje, přestože jde o čtení. Vyhledání částí nahrávání, dokončení a zrušení pokračují v již autorizovaném přenosu přes /call.

Přesný věcný vstup pošlete na /prepare. Úspěšná odpověď obsahuje status: "confirmation_required", confirmationCapability, expiresAt, inputDigest a volitelný summary.
Před vypršením platnosti pošlete stejný vstup na /confirm. Vrácené potvrzovací oprávnění vložte do X-Publish-Confirmation a nový klíč vytvořený volajícím do Idempotency-Key.
Uchovejte vstup, potvrzovací oprávnění a klíč společně. Po přerušeném nebo nejistém potvrzení použijte pro stejný požadavek znovu všechny 3 hodnoty. Nejistý výsledek neobnovujte přípravou náhradní akce.

Idempotentní klíč obsahuje 16–200 znaků z A–Z, a–z, 0–9, ., _, : a -. Potvrzovací oprávnění jsou neprůhledné tajné hodnoty. Klíč poslaný na /call nebo /prepare nerezervuje potvrzený zápis.

Transportní potvrzení je oddělené od schválení publikování. Při publikování nebo změně plánu předložte úplný aktuální podklad ke kontrole: účty, text, nastavení, skutečné náhledy médií nebo odkazy, naplánovaný čas a časové pásmo. U způsobilých kontrol sociálního textu, obrázků a videí může klient předat nový výslovný lidský souhlas pomocí approval: "approved"; nesmí si souhlas vymýšlet ani za něj považovat přípravu. Influence jej zaznamená jako souhlas nahlášený klientem. Podporovaná vložená karta nebo kontrola po přihlášení zaznamenává vlastní akci člověka.

TikTok Direct přijímá výslovné volby a souhlas v chatu přes postup kontroly. Úplné volby uložte pomocí campaignReview a před provedením získejte nové schválení aktualizované kontroly. Karta ke kontrole je volitelná. Běžné plánování API/CLI nečerpá limit plánování AI; samostatný limit MCP a Influence IQ se řídí těmito postupy, i když je uložená AI kontrola později schválena v Influence. Ostatní požadavky tarifu a poskytovatele stále platí. Před další akcí načtěte uložený záznam výsledku; needs_review vyžaduje ověření skutečného stavu, nikoli nové odeslání.

Chyby a nejisté výsledky

Kontrolujte stav HTTP i tělo odpovědi. Úspěšné nástroje vracejí {"ok":true,"toolName":"…","output":{…}}. Chyby nástrojů vracejí {"ok":false,"toolName":"…","error":{"code":"…","message":"…","retryable":false}} a mohou přijít s HTTP 200. Transportní chyby používají {"error":{"code":"…","message":"…","retryable":false}} bez ok a toolName.

Kód 401 znamená požadavek na ověření; zkontrolujte vypršení platnosti nebo odvolání přístupu. Chybějící oprávnění vyžaduje příslušné povolení, ne opakované požadavky. Kód 503 může znamenat nedostupnost služby nebo to, že pracovní prostor právě aktualizuje jiný požadavek plánování. Řiďte se vráceným kódem chyby a pokyny k opakování; akci publikování automaticky neopakujte. Timeout nedokazuje, že zápis selhal: uchovejte jeho potvrzovací údaje a před opakováním načtěte aktuální stav. Přijetí, naplánování a publikování jsou různé výsledky.

Nahrávání médií

Pro místní soubory upřednostněte uploadMedia ze SDK nebo media:upload z CLI. Používají stejné nástroje vícedílného nahrávání a při opakování zachovávají stabilní clientKey. Přiložit lze pouze připravený výsledek s assetId. Pro autorizovaný odkaz HTTPS použijte mediaImport s url a volitelným name. Skutečné odkazy na hostitelské soubory používají samostatný objekt file; veřejná URL nepotřebuje vymyšlené ID hostitelského souboru. Místní cesta není URL ke stažení. Viz limity médií: import videa přes HTTPS má strop 250 MiB, i když přímé nahrání umožňuje větší hotové MP4.

POST /api/v1/media/import podporuje existující přenos malých obrázků: připravte mediaImport s přesným popisem nahrávání a poté odešlete stejné bajty jako application/octet-stream. Připojte X-Publish-Confirmation, Idempotency-Key a X-Publish-Upload s popisem JSON zakódovaným pro URI. Bajty musí odpovídat jeho velikosti a SHA-256. Tento přenos je omezený na 3 MiB; pro větší podporované soubory použijte pomocnou funkci nahrávání. Nahrání nikdy neschvaluje publikování.

Projděte referenci API nebo stáhněte specifikaci OpenAPI.