Tool met leestoegang aanroepen

Roep een tool met alleen leestoegang aan. Verstuur {input: {…}} volgens het schema van de tool in het pad. JSON-verzoeken zijn beperkt tot 65536 bytes. Een antwoord met status 200 kan ok:false bevatten.

POST/api/v1/tools/{tool}/call

Autorisatie

AuthorizationBearer-token · headerverplicht

Influence-API-sleutel met beperkte rechten of ondersteund OAuth-toegangstoken. Zet toegangsgegevens niet in URL’s of toolinvoer.

Padparameters

toolstringverplicht

Toolnaam uit GET /api/v1/tools. De lijst wordt gefilterd op de rechten van je toegangsgegevens; een schema betekent niet dat de tool beschikbaar is.

Verzoekinhoud

verplichtapplication/json

inputobjectverplicht

Antwoorden

200

Toolresultaat; controleer ok en error.

Precies één van:

object

okbooleanverplicht

output__schema0verplicht

Eigenschappen tonen

__schema0

toolNamestringverplicht

Toegestane waarden:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

Toegestane waarden:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringverplicht

min. lengte: 1 · max. lengte: 2048

retryablebooleanverplicht

okbooleanverplicht

toolNamestringverplicht

400

Ongeldig verzoek. Queryparameters zijn niet toegestaan. Validatiefouten kunnen het foutformaat van de tool gebruiken.

Een of meer van:

TransportError

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

ToolError

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

Toegestane waarden:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringverplicht

min. lengte: 1 · max. lengte: 2048

retryablebooleanverplicht

okbooleanverplicht

toolNamestringverplicht

401

Bearer-toegangsgegevens ontbreken, zijn ongeldig of verlopen.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

403

De toegangsgegevens missen de vereiste rechten.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

404

De API of de gevraagde tool is niet beschikbaar.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

413

Het verzoek overschrijdt de bytelimiet.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

Toegestane waarden:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringverplicht

min. lengte: 1 · max. lengte: 2048

retryablebooleanverplicht

okbooleanverplicht

toolNamestringverplicht

429

De limiet voor verzoeken is bereikt. Je kunt het opnieuw proberen.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

503

De API of de dienst die de opdracht uitvoert is niet beschikbaar.

errorobjectverplicht

Eigenschappen tonen

codestringverplicht

messagestringverplicht

retryablebooleanverplicht

Verzoek

curl -X POST 'https://influence.so/api/v1/tools/string/call' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}'

const response = await fetch("https://influence.so/api/v1/tools/string/call", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/tools/string/call",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}",
)

Antwoord

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}