Confirmar um envio binário de imagem

Confirme um descritor de envio preparado de mediaImport com os bytes originais JPEG, PNG ou WebP (no máximo 3.145.728 bytes). O tamanho em bytes e o SHA-256 devem corresponder ao descritor. Para referências de arquivo ou arquivos locais maiores, use as ferramentas de mídia documentadas e o fluxo multipart do SDK.

POST/api/v1/media/import

Autorização

AuthorizationToken Bearer · headerobrigatório

Chave de API do Influence com escopos definidos ou token de acesso OAuth compatível. Mantenha credenciais fora de URLs e da entrada das ferramentas.

Parâmetros de cabeçalho

X-Publish-ConfirmationConfirmationCapabilityobrigatório

O valor exato de confirmationCapability retornado por prepare. Envie-o apenas neste cabeçalho, com a mesma entrada, antes de expiresAt.

comprimento mínimo: 32 · comprimento máximo: 4096 · corresponde a ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobrigatório

Identidade de nova tentativa gerada pelo cliente que faz a chamada. Preserve esta chave, a capacidade de confirmação e a entrada após uma resposta incerta.

comprimento mínimo: 16 · comprimento máximo: 200 · corresponde a ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobrigatório

encodeURIComponent(JSON.stringify(upload)) da entrada preparada de mediaImport. O objeto decodificado segue BinaryUploadDescriptor; o cabeçalho codificado tem no máximo 4.096 caracteres.

comprimento máximo: 4096

Corpo da solicitação

obrigatórioapplication/octet-stream

string<binary>

Respostas

200

Resultado de mídia; inspecione ok e o status do recurso.

Exatamente uma das opções:

object

okbooleanobrigatório

outputJsonValue | nullobrigatório

Mostrar propriedades

Uma ou mais das opções:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array de JsonValue

Referência circular a JsonValue.

object

object

toolNamestringobrigatório

Valores permitidos:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

Valores permitidos:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobrigatório

comprimento mínimo: 1 · comprimento máximo: 2048

retryablebooleanobrigatório

okbooleanobrigatório

toolNamestringobrigatório

400

Solicitação inválida. Parâmetros de consulta não são aceitos. Falhas de validação da ferramenta podem usar a estrutura de erro da ferramenta.

Uma ou mais das opções:

TransportError

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

ToolError

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

comprimento mínimo: 1 · comprimento máximo: 2048

retryablebooleanobrigatório

okbooleanobrigatório

toolNamestringobrigatório

401

Credencial bearer ausente, inválida ou expirada.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

403

A credencial não tem as permissões necessárias.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

404

A API para automações ou a ferramenta solicitada está indisponível.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

413

A solicitação excede o limite de bytes.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

comprimento mínimo: 1 · comprimento máximo: 2048

retryablebooleanobrigatório

okbooleanobrigatório

toolNamestringobrigatório

429

Limite de solicitações excedido. É possível tentar novamente após este erro.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

503

A API ou o serviço responsável pela execução está indisponível.

errorobjectobrigatório

Mostrar propriedades

codestringobrigatório

messagestringobrigatório

retryablebooleanobrigatório

Solicitação

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",
)

Resposta

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