Подтвердить загрузку двоичных данных изображения

Подтвердите подготовленный дескриптор загрузки mediaImport исходными байтами JPEG, PNG или WebP (не более 3 145 728 байт). Длина в байтах и SHA-256 должны совпадать с дескриптором. Для ссылок на файлы или более крупных локальных файлов используйте описанные инструменты работы с медиа и процесс multipart-загрузки через SDK.

POST/api/v1/media/import

Авторизация

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

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

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

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

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

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

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

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

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

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

encodeURIComponent(JSON.stringify(upload)) из подготовленных входных данных mediaImport. Декодированный объект соответствует BinaryUploadDescriptor; длина закодированного заголовка — не более 4 096 символов.

макс. длина: 4096

Тело запроса

обязательноapplication/octet-stream

string<binary>

Ответы

200

Результат работы с медиа; проверьте ok и статус медиафайла.

Одно из:

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/media/import' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'X-Publish-Upload: string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/octet-stream' \
  -d 'string'

const response = await fetch("https://influence.so/api/v1/media/import", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "X-Publish-Upload": "string",
    "Accept": "application/json",
    "Content-Type": "application/octet-stream"
  },
  body: "string"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/media/import",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "X-Publish-Upload": "string",
        "Accept": "application/json",
        "Content-Type": "application/octet-stream"
    },
    data="string",
)

Ответ

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