HTTP-API

Autentisera, hitta verktyg och bekräfta ändringar via det befintliga HTTP-API:et.

Skicka produktens API-begäranden till din betrodda Influence-adress, till exempel https://influence.so. Dokumentationsdomänen tar inte emot produktens API-begäranden. Använd exakt de sökvägar som visas nedan utan frågeparametrar.

Skapa en API-nyckel med avgränsade behörigheter

I Inställningar i Influence öppnar du Appar och automatiseringar → API-nycklar. Välj de behörigheter du behöver och en giltighetstid. Spara nyckeln, som visas 1 gång, i din hemlighetshantering som PUBLISH_API_TOKEN. Skicka den i Authorization: Bearer …; lägg den aldrig i en URL, begärandekropp eller chatt. Återkalla den när den inte längre behövs.

Hitta verktyg och läs konton

Sätt PUBLISH_API_URL till den betrodda ursprungsadressen. Exemplen förutsätter att processen redan har PUBLISH_API_TOKEN. accountList kräver integrations:read; följ fälten för sidindelning för att hämta fler sidor.

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":{}}'

Sökvägar för begäranden

JSON-begäranden till verktyg använder Content-Type: application/json och en kropp som bara innehåller input: {"input":{…}}. Hämta varje verktygs indataschema från den aktuella verktygskatalogen.

Förbered och bekräfta åtgärder

Använd katalogens fält confirmation: läsningar kräver oftast ingen bekräftelse, men en uppdatering av Insikter kräver det trots att den är en läsning. Uppslagning av uppladdningsdelar, slutförande och avbrytande fortsätter en redan godkänd uppladdning via /call.

1. Skicka de exakta indata för verksamhetsåtgärden till /prepare. Ett lyckat svar innehåller status: "confirmation_required", confirmationCapability, expiresAt, inputDigest och eventuellt summary.
2. Skicka samma indata till /confirm innan giltighetstiden löper ut. Lägg det returnerade bekräftelsevärdet i X-Publish-Confirmation och en ny klientgenererad nyckel i Idempotency-Key.
3. Behåll indata, bekräftelsevärdet och nyckeln tillsammans. Efter en avbruten eller osäker bekräftelse ska du återanvända alla 3 för samma begäran. Förbered inte en ersättningsåtgärd för att hantera ett osäkert resultat.

En idempotensnyckel innehåller 16–200 tecken ur A–Z, a–z, 0–9, ., _, : och -. Bekräftelsevärden är opaka hemligheter. En nyckel som skickas till /call eller /prepare reserverar ingen bekräftad skrivning.

Transportbekräftelse är skild från godkännande av publicering. Vid publicering eller ändring av schemat ska du visa hela den aktuella granskningen: konton, text, inställningar, faktiska medieförhandsvisningar eller länkar, schemalagd tid och tidszon. Klienten kan rapportera ett nytt uttryckligt mänskligt godkännande med approval: "approved" för de granskningar av sociala text-, bild- och videoinlägg som stöds; den får inte hitta på samtycke eller behandla förberedelse som godkännande. Influence registrerar detta som klientrapporterat godkännande. Ett inbäddat kort som stöds eller en inloggad granskning registrerar sin egen mänskliga handling.

TikTok Direct tillåter uttryckliga val och samtycke i chatten via granskningsflödet. Spara de fullständiga valen med campaignReview och få sedan ett nytt godkännande av den uppdaterade granskningen före körning. Ett granskningskort är valfritt. Vanlig API/CLI-schemaläggning förbrukar inte AI-kvoten för schemaläggning; den separata kvoten för MCP och Influence IQ följer dessa flöden även om en sparad AI-granskning senare godkänns i Influence. Andra krav från abonnemang och leverantörer gäller fortfarande. Läs det sparade kvittot före nästa åtgärd; needs_review kräver avstämning, inte en ny sändning.

Hantera fel och osäkra resultat

Kontrollera både HTTP-status och svarskropp. Lyckade verktyg returnerar {"ok":true,"toolName":"…","output":{…}}. Verktygsfel returnerar {"ok":false,"toolName":"…","error":{"code":"…","message":"…","retryable":false}} och kan komma med HTTP 200. Transportfel använder {"error":{"code":"…","message":"…","retryable":false}} utan ok eller toolName.

401 betyder att autentisering krävs; kontrollera utgångstid eller återkallande. En saknad behörighet kräver rätt godkännande, inte upprepade begäranden. 503 kan betyda att tjänsten är otillgänglig eller att en annan schemaläggningsbegäran uppdaterar arbetsytan. Använd den returnerade felkoden och råden om nya försök; kör inte automatiskt en publiceringsåtgärd igen. En timeout bevisar inte att en skrivning misslyckades: behåll bekräftelseuppgifterna och läs aktuell status innan du skickar igen. Accepterat, schemalagt och publicerat är olika utfall.

Ladda upp medier

Använd helst SDK:ets uploadMedia eller CLI:ets media:upload för lokala filer. De använder samma multipartverktyg och behåller en stabil clientKey för nya försök. Endast ett klart resultat med assetId kan bifogas. För en godkänd HTTPS-länk använder du mediaImport med url och valfritt name. Verkliga filreferenser från värden använder det separata objektet file; en offentlig URL behöver inget påhittat värdfil-ID. En lokal filsökväg är ingen nedladdningsadress. Se mediegränser: import av HTTPS-video är begränsad till 250 MiB, även när en större färdig MP4 tillåts via direkt uppladdning.

POST /api/v1/media/import stöder den befintliga transporten för små bilder: förbered mediaImport med den exakta uppladdningsbeskrivningen och skicka sedan samma byte som application/octet-stream. Ta med X-Publish-Confirmation, Idempotency-Key och X-Publish-Upload med uppladdningsbeskrivningen som URI-kodad JSON. Byten måste matcha storleken och SHA-256. Transporten är begränsad till 3 MiB; använd uppladdningshjälpen för större filer som stöds. Uppladdning godkänner aldrig publicering.

Bläddra i API-referensen eller ladda ner OpenAPI-specifikationen.