调用无需确认的工具

调用发现描述符中标为confirmation: “none”的工具，包括读取数据和继续已获授权的上传。使用与路径中工具名称对应的结构定义，发送{input: {…}}。JSON请求上限为65,536字节。200响应也可能包含ok:false。

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

授权

AuthorizationBearer令牌 · header必需

具有限定权限范围的Influence API密钥，或受支持的OAuth访问令牌。不要将凭据放入URL或工具输入。

路径参数

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必需

允许值：AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

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必需

允许值：AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

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