변경 확인

필수 헤더 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
  }
}