Kald et værktøj uden bekræftelse

Kald et værktøj, hvis deskriptor i værktøjsoversigten har confirmation: “none”. Det omfatter læsning af data og fortsættelse af en allerede autoriseret upload. Send {input: {…}} med det skema, der svarer til værktøjsnavnet i stien. JSON-anmodninger er begrænset til 65.536 bytes. Et 200-svar kan indeholde ok:false.

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

Autorisation

AuthorizationBearer-token · headerpåkrævet

Influence-API-nøgle med afgrænsede tilladelser eller understøttet OAuth-adgangstoken. Hold adgangsoplysninger ude af URL’er og værktøjsinput.

Stiparametre

toolstringpåkrævet

Værktøjsnavn returneret af GET /api/v1/tools. Værktøjsoversigten filtreres efter adgangsoplysningernes tilladelser; et skema betyder ikke i sig selv, at værktøjet er tilgængeligt.

Anmodningsindhold

påkrævetapplication/json

inputobjectpåkrævet

Svar

200

Værktøjsresultat; kontrollér ok og error.

Præcis én af:

object

okbooleanpåkrævet

outputJsonValue | nullpåkrævet

Vis egenskaber

En eller flere af:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array af JsonValue

Cirkulær reference til JsonValue.

object

object

toolNamestringpåkrævet

Tilladte værdier:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

Tilladte værdier:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

400

Ugyldig anmodning. Forespørgselsparametre accepteres ikke. Valideringsfejl i et værktøj kan returneres i værktøjets fejlformat.

En eller flere af:

TransportError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

ToolError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

401

Manglende, ugyldige eller udløbne Bearer-adgangsoplysninger.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

403

Adgangsoplysningerne mangler de påkrævede tilladelser.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

404

Maskin-API’et eller det ønskede værktøj er ikke tilgængeligt.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

413

Anmodningen overskrider bytegrænsen.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

429

Kaldgrænsen er overskredet. Der kan forsøges igen.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

503

API’et eller den bagvedliggende afvikling er ikke tilgængelig.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

Anmodning

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}",
)

Svar

{
  "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": "AI_SCHEDULING_LIMIT_REACHED",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

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

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