Подтвердить изменение

Подтвердите те же подготовленные входные данные, передав оба обязательных заголовка. Дополнительные правила проверки перед публикацией и одобрения человеком по-прежнему действуют. Ответ со статусом 200 может содержать ok:false; принятая или запланированная работа не подтверждает публикацию. Размер запросов JSON ограничен 65 536 байтами.

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

Авторизация

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

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

Параметры пути

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

Имя инструмента, возвращённое GET /api/v1/tools. Список фильтруется по разрешениям этих учётных данных; наличие схемы не подтверждает доступность.

Параметры заголовков

X-Publish-ConfirmationConfirmationCapabilityобязательно

Точное значение confirmationCapability, полученное от prepare. Передавайте его только в этом заголовке, с теми же входными данными и до expiresAt.

мин. длина: 32 · макс. длина: 4096 · соответствует ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyобязательно

Идентификатор повторной попытки, созданный вызывающей стороной. После ответа с неясным результатом сохраняйте этот ключ, значение подтверждения и входные данные.

мин. длина: 16 · макс. длина: 200 · соответствует ^[A-Za-z0-9._:-]+$

Тело запроса

обязательно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/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -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/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "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/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "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
  }
}