确认变更

使用2个必需的请求头，确认相同的已准备输入。其他发布审核和人工批准规则仍然适用。200响应也可能包含ok:false；工作已受理或已定时，不代表已经发布。JSON请求上限为65,536字节。

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

授权

AuthorizationBearer令牌 · header必需

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

路径参数

toolstring必需

GET /api/v1/tools返回的工具名称。发现结果会按此凭据的权限筛选；存在结构定义不代表工具可用。

请求头参数

X-Publish-ConfirmationConfirmationCapability必需

prepare返回的confirmationCapability原值。仅通过此请求头，在expiresAt之前，连同相同的输入一起发送。

最小长度：32 · 最大长度：4096 · 匹配^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKey必需

调用方生成的重试标识。响应结果不确定时，请保留此幂等键、确认凭据和输入。

最小长度：16 · 最大长度：200 · 匹配^[A-Za-z0-9._:-]+$

请求体

必需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/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -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/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "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/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "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
  }
}