Вызвать инструмент без подтверждения

Вызовите инструмент, в дескрипторе которого указано confirmation: “none”. Это включает чтение данных и продолжение уже разрешённой загрузки. Передайте {input: {…}} по схеме, соответствующей имени инструмента в пути. Размер запросов JSON ограничен 65 536 байтами. Ответ со статусом 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обязательно

outputJsonValue | nullобязательно

Показать свойства

Любые из:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Массив элементов типа JsonValue

Циклическая ссылка на JsonValue.

object

object

toolNamestringобязательно

Допустимые значения:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectобязательно

Показать свойства

codestringобязательно

Допустимые значения:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringобязательно

мин. длина: 1 · макс. длина: 2048

retryablebooleanобязательно

okbooleanобязательно

toolNamestringобязательно

400

Недопустимый запрос. Параметры строки запроса не принимаются. Ошибки проверки инструмента могут возвращаться в формате ошибки инструмента.

Любые из:

TransportError

errorobjectобязательно

Показать свойства

codestringобязательно

messagestringобязательно

retryablebooleanобязательно

ToolError

errorobjectобязательно

Показать свойства

codestringобязательно

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обязательно

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