読み取り専用ツールを呼び出す

読み取り専用ツールを呼び出します。パスで指定したツールのスキーマに従い、{input: {…}} を送信してください。JSON リクエストの上限は 65536 バイトです。200 応答でも ok:false が含まれる場合があります。

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

認可

AuthorizationBearer トークン · header必須

権限範囲を指定した Influence API キー、または対応する OAuth アクセストークンを使用します。認証情報を URL やツールの入力に含めないでください。

パスパラメーター

toolstring必須

GET /api/v1/tools が返すツール名です。一覧は認証情報の権限で絞り込まれます。スキーマの存在は利用可能であることを保証しません。

リクエスト本文

必須application/json

inputobject必須

レスポンス

200

ツールの結果です。ok と error を確認してください。

次のうち1つのみ:

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

リクエストが無効です。クエリパラメーターは受け付けません。入力検証の失敗はツールエラー形式で返される場合があります。

次のうち1つ以上:

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