確認變更操作

帶齊必要標頭，確認相同的已準備輸入。其他發布審核與人工核准規則仍然適用。200 回應可能包含 ok:false；已接受或已排程，不代表已發布。JSON 請求上限為 65,536 位元組。

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

授權

AuthorizationBearer 權杖 · header必要

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

路徑參數

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

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