Panggil tool hanya-baca

Panggil tool hanya-baca. Kirim {input: {…}} sesuai skema tool pada path. Permintaan JSON dibatasi hingga 65536 byte. Respons 200 dapat berisi ok:false.

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

Otorisasi

AuthorizationToken Bearer · headerwajib

Kunci API Influence dengan izin terbatas atau token akses OAuth yang didukung. Jangan sertakan kredensial dalam URL atau input tool.

Parameter path

toolstringwajib

Nama tool yang dikembalikan oleh GET /api/v1/tools. Daftar difilter berdasarkan izin kredensial; adanya skema tidak menjamin ketersediaan.

Isi permintaan

wajibapplication/json

inputobjectwajib

Respons

200

Hasil tool; periksa ok dan error.

Tepat satu dari:

object

okbooleanwajib

output__schema0wajib

Tampilkan properti

__schema0

toolNamestringwajib

Nilai yang diizinkan:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

400

Permintaan tidak valid. Parameter kueri tidak diterima. Kegagalan validasi dapat menggunakan format error tool.

Satu atau lebih dari:

TransportError

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

ToolError

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

401

Kredensial bearer tidak ada, tidak valid, atau kedaluwarsa.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

403

Kredensial tidak memiliki izin yang diperlukan.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

404

API atau tool yang diminta tidak tersedia.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

413

Permintaan melebihi batas byte.

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

429

Batas permintaan terlampaui. Permintaan dapat dicoba lagi.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

503

API atau layanan yang menjalankan operasi tidak tersedia.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

Permintaan

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

Respons

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