Confirmer l’envoi d’une image binaire

Confirmez un descripteur d’envoi préparé avec mediaImport en transmettant les octets d’origine du JPEG, PNG ou WebP (3145728 octets maximum). La taille et le SHA-256 doivent correspondre au descripteur. Pour les références de fichiers ou les fichiers locaux plus volumineux, utilisez les outils multimédias et l’envoi multipartie du SDK.

POST/api/v1/media/import

Autorisation

AuthorizationJeton Bearer · headerobligatoire

Clé API Influence avec des autorisations limitées ou jeton d’accès OAuth pris en charge. Ne placez jamais les identifiants dans les URL ni dans les données des outils.

Paramètres d’en-tête

X-Publish-ConfirmationConfirmationCapabilityobligatoire

Valeur exacte de confirmationCapability renvoyée par prepare. Envoyez-la uniquement dans cet en-tête, avec les mêmes données, avant expiresAt.

longueur min. : 32 · longueur max. : 4096 · correspond à ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatoire

Identifiant de nouvelle tentative créé par le client. Conservez cette clé, la capacité de confirmation et les données si le résultat est incertain.

longueur min. : 16 · longueur max. : 200 · correspond à ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobligatoire

encodeURIComponent(JSON.stringify(upload)) des données préparées pour mediaImport. L’objet décodé suit BinaryUploadDescriptor ; l’en-tête encodé est limité à 4096 caractères.

longueur max. : 4096

Corps de la requête

obligatoireapplication/octet-stream

string<binary>

Réponses

200

Résultat multimédia ; vérifiez ok et l’état du fichier.

Une seule de:

object

okbooleanobligatoire

output__schema0obligatoire

Afficher les propriétés

__schema0

toolNamestringobligatoire

Valeurs autorisées :adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

400

Requête non valide. Les paramètres de requête sont refusés. Les erreurs de validation peuvent utiliser l’enveloppe d’erreur d’un outil.

Une ou plusieurs de:

TransportError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

ToolError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

401

Identifiant bearer absent, non valide ou expiré.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

403

Les identifiants ne disposent pas des autorisations requises.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

404

L’API ou l’outil demandé est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

413

La requête dépasse la limite en octets.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

429

Limite de requêtes dépassée. Une nouvelle tentative est possible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

503

L’API ou le service chargé de l’exécution est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

Requête

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

Réponse

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