呼叫不需確認的工具

呼叫探索描述中標示 confirmation: “none” 的工具，包括讀取資料及接續已授權的上傳。依路徑中的工具名稱，使用相符結構傳送 {input: {…}}。JSON 請求上限為 65,536 位元組。200 回應仍可能包含 ok:false。

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

授權

AuthorizationBearer 權杖 · header必要

使用 Influence 限定權限的 API 金鑰，或受支援的 OAuth 存取權杖。不要將憑證放在網址或工具輸入中。

路徑參數

toolstring必要

由 GET /api/v1/tools 傳回的工具名稱。探索結果依此憑證權限篩選；結構存在，不代表工具可用。

請求主體

必要application/json

inputobject必要

回應

200

工具結果；請檢查 ok 與 error。

僅符合下列其中一項:

object

okboolean必要

outputJsonValue | null必要

展開屬性

符合下列任一或多項:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

由 JsonValue 組成的陣列

循環參照至 JsonValue。

object

object

toolNamestring必要

允許的值：adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobject必要

展開屬性

codestring必要

允許的值：AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestring必要

長度下限：1 · 長度上限：2048

retryableboolean必要

okboolean必要

toolNamestring必要

400

請求無效。不接受查詢參數。工具驗證失敗可能使用工具錯誤封裝格式。

符合下列任一或多項:

TransportError

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

ToolError

errorobject必要

展開屬性

codestring必要

messagestring必要

長度下限：1 · 長度上限：2048

retryableboolean必要

okboolean必要

toolNamestring必要

401

未提供 bearer 憑證，或憑證無效、已到期。

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

403

憑證缺少必要權限。

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

404

供程式呼叫的 API 或要求的工具無法使用。

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

413

請求超過位元組上限。

errorobject必要

展開屬性

codestring必要

messagestring必要

長度下限：1 · 長度上限：2048

retryableboolean必要

okboolean必要

toolNamestring必要

429

已超過速率限制。此錯誤可重試。

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

503

API 或其上游執行環節無法使用。

errorobject必要

展開屬性

codestring必要

messagestring必要

retryableboolean必要

請求

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

回應

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