HTTP-API

Authenticeer, ontdek tools en bevestig wijzigingen via de bestaande HTTP-API.

Stuur productaanvragen naar je vertrouwde Influence-origin, zoals https://influence.so. Het documentatiedomein accepteert geen aanvragen voor de product-API. Gebruik onderstaande paden exact, zonder queryparameters.

Maak een API-sleutel met beperkte rechten

Open in de Influence-instellingen Apps en automatiseringen → API-sleutels. Kies de benodigde rechten en een vervaldatum. Bewaar de eenmalig getoonde sleutel in je geheimenopslag als PUBLISH_API_TOKEN. Verstuur hem via Authorization: Bearer …, nooit in een URL, aanvraaginhoud of chat. Trek hem in wanneer je hem niet meer nodig hebt.

Ontdek tools en lees gegevens

Stel PUBLISH_API_URL in op de vertrouwde origin. De voorbeelden gaan ervan uit dat het proces al PUBLISH_API_TOKEN heeft. accountList vereist integrations:read; gebruik de pagineringsvelden om volgende pagina’s op te halen.

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

Aanvraagpaden

Methode	Pad	Doel
`GET`	`/api/v1/tools`	Toont de tools die met dit toegangsbewijs beschikbaar zijn.
`POST`	`/api/v1/tools/{tool}/call`	Roept een tool voor alleen lezen aan.
`POST`	`/api/v1/tools/{tool}/prepare`	Bereidt een exacte wijziging voor zonder die uit te voeren.
`POST`	`/api/v1/tools/{tool}/confirm`	Bevestigt de voorbereide wijziging.
`POST`	`/api/v1/media/import`	Bevestigt een voorbereide kleine binaire afbeeldingsupload.

JSON-aanvragen gebruiken Content-Type: application/json en bevatten alleen input: {"input":{…}}. Het invoerschema van elke tool staat in de actuele catalogus.

Bereid wijzigingen voor en bevestig ze

Stuur de exacte invoer naar /prepare. Een geslaagd antwoord bevat status: "confirmation_required", confirmationCapability, expiresAt, inputDigest en eventueel summary.
Stuur vóór de vervaltijd dezelfde invoer naar /confirm. Zet de ontvangen bevestigingswaarde in X-Publish-Confirmation en een nieuwe, door je client gegenereerde sleutel in Idempotency-Key.
Bewaar invoer, bevestigingswaarde en sleutel samen. Gebruik na een onderbroken of onzekere bevestiging alle drie opnieuw voor dezelfde aanvraag. Bereid geen vervangende handeling voor om een onzeker resultaat te herstellen.

Een idempotentiesleutel bevat 16–200 tekens uit A–Z, a–z, 0–9, ., _, : en -. Bevestigingswaarden zijn geheime, ondoorzichtige tokens. Een sleutel bij /call of /prepare reserveert geen bevestigde wijziging.

Een aanvraag bevestigen staat los van publicatie goedkeuren. Maak en toon voor publicatie of planningswijzigingen de volledige actuele controle. Tekst vereist daarna een nieuwe goedkeuring. Afbeeldingen en video’s vereisen visuele goedkeuring door de persoon in een ondersteunde interface of na inloggen bij Influence. Een voorbereide controle publiceert niets. Lees vóór verdere actie het opgeslagen resultaat; bij needs_review moet je uitzoeken wat er is gebeurd, niet opnieuw verzenden.

Verwerk fouten en onzekere resultaten

Controleer de HTTP-status én de inhoud. Succes geeft {"ok":true,"toolName":"…","output":{…}}. Een toolfout geeft {"ok":false,"toolName":"…","error":{"code":"…","message":"…","retryable":false}}, soms met HTTP 200. Transportfouten gebruiken {"error":{"code":"…","message":"…","retryable":false}} zonder ok of toolName.

401 vereist authenticatie: controleer verval of intrekking. Ontbrekende rechten vragen om passende toestemming, niet om herhaalde aanvragen. 503 betekent dat de API in die omgeving niet beschikbaar is. Volg fouten en aanwijzingen voor herhalen. Een time-out bewijst niet dat een wijziging is mislukt: bewaar de bevestigingsgegevens en lees de status vóór opnieuw verzenden. Geaccepteerd, gepland en gepubliceerd zijn verschillende resultaten.

Upload media

Gebruik voor lokale bestanden bij voorkeur uploadMedia in de SDK of media:upload in de CLI. Ze gebruiken dezelfde tools voor uploads in delen en behouden een stabiele clientKey voor herhalingen. Alleen een gereed resultaat met assetId kun je bijvoegen. Gebruik mediaImport voor geautoriseerde HTTPS-bestandsverwijzingen; een lokaal pad is geen download-URL.

POST /api/v1/media/import ondersteunt het bestaande transport voor kleine afbeeldingen: bereid mediaImport voor met de exacte uploaddescriptor en stuur dezelfde bytes als application/octet-stream. Voeg X-Publish-Confirmation, Idempotency-Key en X-Publish-Upload toe, met de JSON-descriptor gecodeerd voor een URI. Grootte en SHA-256 moeten overeenkomen met de bytes. De limiet is 3 MiB; gebruik de uploadhelper voor grotere ondersteunde bestanden. Uploaden keurt publicatie nooit goed.

Bekijk de API-referentie of download de OpenAPI-specificatie.