Найти доступные инструменты

Возвращает имена инструментов, описания, разрешения, требования к подтверждению и схемы входных данных, доступные учётным данным Bearer.

GET/api/v1/tools

Авторизация

AuthorizationТокен Bearer · headerобязательно

Ключ API Influence с ограниченными правами или поддерживаемый токен доступа OAuth. Не передавайте учётные данные в URL и входных данных инструмента.

Ответы

200

Дескрипторы доступных инструментов.

toolsobject[]обязательно

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Допустимые значения:readexternal-readwriteexternal-write

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

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

scopesstring[]обязательно

макс. элементов: 4

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

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

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

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

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

400

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

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

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

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

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

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

401

Учётные данные для аутентификации Bearer отсутствуют, недействительны или просрочены.

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

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

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

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

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

403

У учётных данных нет необходимых разрешений.

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

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

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

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

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

404

Машинный API или запрошенный инструмент недоступен.

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

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

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

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

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

429

Превышен лимит частоты запросов. После этой ошибки можно повторить попытку.

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

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

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

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

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

503

Недоступен API или сервис выполнения запросов.

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

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

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

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

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

Запрос

curl -X GET 'https://influence.so/api/v1/tools' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://influence.so/api/v1/tools", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://influence.so/api/v1/tools",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Ответ

{
  "tools": [
    {
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "readOnlyHint": true
      },
      "confirmation": "none",
      "description": "string",
      "gate": "core",
      "mutability": "read",
      "name": "adAuditQuote",
      "scopes": [
        "integrations:read"
      ],
      "title": "string",
      "inputSchema": {
        "type": "object",
        "property1": "string",
        "property2": "string"
      },
      "property1": "string",
      "property2": "string"
    }
  ],
  "property1": "string",
  "property2": "string"
}

{
  "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": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}