Gọi công cụ không cần xác nhận

Gọi công cụ có confirmation: “none” trong bộ mô tả khám phá. Bao gồm đọc dữ liệu và tiếp tục một lần tải lên đã được cấp quyền. Gửi {input: {…}} bằng lược đồ khớp với tên công cụ trong đường dẫn. Yêu cầu JSON có giới hạn 65.536 byte. Phản hồi 200 có thể chứa ok:false.

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

Ủ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.

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/call' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -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/call", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "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/call",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "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
  }
}