Conferma il caricamento binario di un’immagine

Conferma un descrittore di caricamento mediaImport preparato con i byte originali del file JPEG, PNG o WebP (massimo 3.145.728 byte). La lunghezza in byte e SHA-256 devono corrispondere al descrittore. Per i riferimenti a file o per file locali più grandi, usa gli strumenti multimediali e il flusso multipart dell’SDK documentati.

POST/api/v1/media/import

Autorizzazione

AuthorizationToken Bearer · headerobbligatorio

Chiave API Influence con ambiti di autorizzazione limitati o token di accesso OAuth supportato. Tieni le credenziali fuori dagli URL e dall’input degli strumenti.

Parametri degli header

X-Publish-ConfirmationConfirmationCapabilityobbligatorio

Il valore esatto di confirmationCapability restituito da prepare. Invialo soltanto in questo header, con lo stesso input, prima di expiresAt.

lunghezza minima 32 · lunghezza massima 4096 · corrisponde a ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobbligatorio

Identificativo dei nuovi tentativi generato dal chiamante. Conserva questa chiave, la capability e l’input dopo una risposta dall’esito incerto.

lunghezza minima 16 · lunghezza massima 200 · corrisponde a ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobbligatorio

encodeURIComponent(JSON.stringify(upload)) dall’input mediaImport preparato. L’oggetto decodificato segue BinaryUploadDescriptor; l’header codificato ha un massimo di 4.096 caratteri.

lunghezza massima 4096

Corpo della richiesta

obbligatorioapplication/octet-stream

string<binary>

Risposte

200

Risultato del contenuto multimediale; controlla ok e lo stato della risorsa.

Una sola delle seguenti opzioni:

object

okbooleanobbligatorio

outputJsonValue | nullobbligatorio

Mostra le proprietà

Almeno una delle seguenti opzioni:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array di JsonValue

Riferimento circolare a JsonValue.

object

object

toolNamestringobbligatorio

Valori consentiti:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

Valori consentiti:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

400

Richiesta non valida. I parametri di query non sono accettati. Gli errori di convalida degli strumenti possono usare una struttura di risposta di errore dello strumento.

Almeno una delle seguenti opzioni:

TransportError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

ToolError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

401

Credenziale Bearer mancante, non valida o scaduta.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

403

La credenziale non dispone delle autorizzazioni richieste.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

404

L’API per l’accesso programmatico o lo strumento richiesto non è disponibile.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

413

La richiesta supera il limite in byte.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

429

Limite di frequenza superato. È possibile riprovare.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

503

L’API o il servizio di esecuzione a monte non è disponibile.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

Richiesta

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

Risposta

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