Xác nhận thao tác thay đổi

Xác nhận cùng đầu vào đã chuẩn bị bằng cả 2 tiêu đề bắt buộc. Các quy tắc bổ sung về xem lại để đăng và phê duyệt của con người vẫn áp dụng. Phản hồi 200 có thể chứa ok:false; tác vụ được chấp nhận hoặc lên lịch không chứng minh đã đăng. Yêu cầu JSON có giới hạn 65.536 byte.

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

Ủy quyền

AuthorizationToken Bearer · headerbắt buộc

Khóa API Influence có phạm vi quyền cụ thể hoặc token truy cập OAuth được hỗ trợ. Không đưa thông tin xác thực vào URL hay đầu vào công cụ.

Tham số đường dẫn

toolstringbắt buộc

Tên công cụ do GET /api/v1/tools trả về. Việc khám phá được lọc theo quyền của thông tin xác thực này; có lược đồ không chứng minh công cụ khả dụng.

Tham số tiêu đề

X-Publish-ConfirmationConfirmationCapabilitybắt buộc

Giá trị confirmationCapability chính xác do prepare trả về. Chỉ gửi trong tiêu đề này, với cùng đầu vào, trước expiresAt.

độ dài tối thiểu 32 · độ dài tối đa 4096 · khớp ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeybắt buộc

Mã định danh do bên gọi tạo để dùng khi thử lại. Giữ nguyên khóa này, giá trị confirmationCapability và đầu vào sau phản hồi chưa rõ kết quả.

độ dài tối thiểu 16 · độ dài tối đa 200 · khớp ^[A-Za-z0-9._:-]+$

Nội dung yêu cầu

bắt buộcapplication/json

inputobjectbắt buộc

Các phản hồi

200

Kết quả công cụ; kiểm tra ok và error.

Đúng một phương án:

object

okbooleanbắt buộc

outputJsonValue | nullbắt buộc

Hiện thuộc tính

Ít nhất một phương án:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Mảng gồm JsonValue

Tham chiếu vòng đến JsonValue.

object

object

toolNamestringbắt buộc

Cho phép:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

400

Yêu cầu không hợp lệ. Không chấp nhận tham số truy vấn. Lỗi kiểm tra dữ liệu của công cụ có thể dùng cấu trúc phản hồi lỗi của công cụ.

Ít nhất một phương án:

TransportError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

ToolError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

401

Thông tin xác thực Bearer bị thiếu, không hợp lệ hoặc hết hạn.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

403

Thông tin xác thực thiếu các quyền cần thiết.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

404

API dành cho máy hoặc công cụ được yêu cầu không khả dụng.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

413

Yêu cầu vượt giới hạn byte.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

429

Vượt giới hạn tần suất. Có thể thử lại khi gặp lỗi này.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

503

API hoặc quá trình thực thi phía sau API không khả dụng.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

Yêu cầu

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}",
)

Phản hồi

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