เรียกเครื่องมือแบบอ่านอย่างเดียว

เรียกเครื่องมือแบบอ่านอย่างเดียว ส่ง {input: {…}} ตามสคีมาของเครื่องมือที่ระบุในพาธ คำขอ JSON มีขนาดได้ไม่เกิน 65536 ไบต์ การตอบกลับ 200 อาจมี ok:false

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

การอนุญาตสิทธิ์

Authorizationโทเค็น Bearer · headerจำเป็น

ใช้คีย์ API ของ Influence ที่กำหนดขอบเขตสิทธิ์ หรือโทเค็นการเข้าถึง OAuth ที่รองรับ ห้ามใส่ข้อมูลยืนยันตัวตนใน URL หรือข้อมูลนำเข้าของเครื่องมือ

พารามิเตอร์พาธ

toolstringจำเป็น

ชื่อเครื่องมือที่ส่งคืนจาก GET /api/v1/tools รายการจะกรองตามสิทธิ์ของข้อมูลยืนยันตัวตน การมีสคีมาไม่ได้ยืนยันว่าเครื่องมือพร้อมใช้งาน

เนื้อหาคำขอ

จำเป็นapplication/json

inputobjectจำเป็น

การตอบกลับ

200

ผลลัพธ์เครื่องมือ โปรดตรวจสอบ ok และ error

เพียงหนึ่งรายการจาก:

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

คำขอไม่ถูกต้อง ไม่รับพารามิเตอร์คิวรี หากตรวจสอบข้อมูลไม่ผ่าน อาจส่งคืนข้อผิดพลาดในรูปแบบของเครื่องมือ

อย่างน้อยหนึ่งรายการจาก:

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

การตอบกลับ

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