Confirmar la subida de una imagen binaria

Confirma un descriptor de subida preparado con mediaImport enviando los bytes originales del JPEG, PNG o WebP (máximo 3145728 bytes). El tamaño y SHA-256 deben coincidir con el descriptor. Para referencias a archivos o archivos locales más grandes, usa las herramientas de medios y el flujo de subida por partes del SDK.

POST/api/v1/media/import

Autorización

AuthorizationToken Bearer · headerobligatorio

Clave de API de Influence con permisos limitados o token de acceso OAuth compatible. No incluyas credenciales en las URL ni en los datos de entrada de las herramientas.

Parámetros de cabecera

X-Publish-ConfirmationConfirmationCapabilityobligatorio

El valor exacto de confirmationCapability devuelto por prepare. Envíalo solo en esta cabecera, con los mismos datos de entrada, antes de expiresAt.

longitud mín.: 32 · longitud máx.: 4096 · coincide con ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatorio

Identificador de reintento generado por el cliente. Conserva esta clave, la capacidad de confirmación y los datos de entrada si el resultado es incierto.

longitud mín.: 16 · longitud máx.: 200 · coincide con ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobligatorio

encodeURIComponent(JSON.stringify(upload)) de los datos preparados para mediaImport. El objeto decodificado sigue BinaryUploadDescriptor; la cabecera codificada admite hasta 4096 caracteres.

longitud máx.: 4096

Cuerpo de la solicitud

obligatorioapplication/octet-stream

string<binary>

Respuestas

200

Resultado del archivo multimedia; comprueba ok y el estado del recurso.

Una de:

object

okbooleanobligatorio

output__schema0obligatorio

Mostrar propiedades

__schema0

toolNamestringobligatorio

Valores permitidos:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

400

Solicitud no válida. No se aceptan parámetros de consulta. Los fallos de validación pueden usar el formato de error de la herramienta.

Una o más de:

TransportError

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

ToolError

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

401

Credencial bearer ausente, no válida o caducada.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

403

Las credenciales no tienen los permisos necesarios.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

404

La API o la herramienta solicitada no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

413

La solicitud supera el límite de bytes.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

429

Se ha superado el límite de solicitudes. Se puede reintentar.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

503

La API o el servicio que ejecuta la operación no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

Solicitud

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

Respuesta

{
  "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": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

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

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