変更を確定

準備したものと同じ入力を、必須の両ヘッダーとともに送信して確定します。公開前の確認と人による承認のルールは引き続き適用されます。200 応答でも ok:false が含まれる場合があります。受付や予約の完了は公開完了を意味しません。JSON リクエストの上限は 65536 バイトです。

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

クライアントが作成する再試行用 ID です。結果が不明な場合は、このキー、確認用の権限値、入力を保持してください。

最小長: 16 · 最大長: 200 · ^[A-Za-z0-9._:-]+$ に一致

リクエスト本文

必須application/json

inputobject必須

レスポンス

200

ツールの結果です。ok と error を確認してください。

次のうち1つのみ:

object

okboolean必須

output__schema0必須

プロパティを表示

__schema0

toolNamestring必須

指定できる値:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobject必須

プロパティを表示

codestring必須

指定できる値:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestring必須

最小長: 1 · 最大長: 2048

retryableboolean必須

okboolean必須

toolNamestring必須

400

リクエストが無効です。クエリパラメーターは受け付けません。入力検証の失敗はツールエラー形式で返される場合があります。

次のうち1つ以上:

TransportError

errorobject必須

プロパティを表示

codestring必須

messagestring必須

retryableboolean必須

ToolError

errorobject必須

プロパティを表示

codestring必須

指定できる値:INVALID_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必須

指定できる値:INVALID_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": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

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

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