Bekräfta en binär bilduppladdning

Bekräfta en förberedd mediaImport-uppladdningsbeskrivning med ursprungliga JPEG-, PNG- eller WebP-byte (högst 3 145 728 byte). Bytelängd och SHA-256 måste stämma med beskrivningen. För filreferenser eller större lokala filer använder du de dokumenterade medieverktygen och SDK:ets multipartflöde.

POST/api/v1/media/import

Auktorisering

AuthorizationBearer-token · headerobligatorisk

Influence-API-nyckel med avgränsade behörigheter eller en OAuth-åtkomsttoken som stöds. Håll autentiseringsuppgifter borta från URL:er och verktygsindata.

Parametrar i anropshuvudet

X-Publish-ConfirmationConfirmationCapabilityobligatorisk

Det exakta confirmationCapability-värdet som prepare returnerar. Skicka det endast i det här huvudet, med samma indata, före expiresAt.

minst 32 tecken · högst 4096 tecken · matchar ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatorisk

Identitet för återförsök, skapad av anroparen. Behåll den här nyckeln, bekräftelsevärdet och indata efter ett osäkert svar.

minst 16 tecken · högst 200 tecken · matchar ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobligatorisk

encodeURIComponent(JSON.stringify(upload)) från förberedda mediaImport-indata. Det avkodade objektet följer BinaryUploadDescriptor; det kodade huvudet är högst 4 096 tecken.

högst 4096 tecken

Anropskropp

obligatoriskapplication/octet-stream

string<binary>

Svar

200

Medieresultat; kontrollera ok och resursens status.

Exakt ett av:

object

okbooleanobligatorisk

outputJsonValue | nullobligatorisk

Visa egenskaper

Minst ett av:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array med element av typen JsonValue

Cirkulär referens till JsonValue.

object

object

toolNamestringobligatorisk

Tillåtna värden:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

Tillåtna värden:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorisk

minst 1 tecken · högst 2048 tecken

retryablebooleanobligatorisk

okbooleanobligatorisk

toolNamestringobligatorisk

400

Ogiltig begäran. Frågeparametrar accepteras inte. Verktygets valideringsfel kan returneras i en struktur för verktygsfel.

Minst ett av:

TransportError

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

ToolError

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

minst 1 tecken · högst 2048 tecken

retryablebooleanobligatorisk

okbooleanobligatorisk

toolNamestringobligatorisk

401

Bearer-autentiseringsuppgifter saknas, är ogiltiga eller har löpt ut.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

403

Autentiseringsuppgifterna saknar nödvändiga behörigheter.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

404

Maskin-API:et eller det begärda verktyget är inte tillgängligt.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

413

Begäran överskrider bytegränsen.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

minst 1 tecken · högst 2048 tecken

retryablebooleanobligatorisk

okbooleanobligatorisk

toolNamestringobligatorisk

429

Anropsgränsen har överskridits. Ett nytt försök kan göras för det här felet.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

503

API:et är inte tillgängligt, eller så är den bakomliggande körningen inte tillgänglig.

errorobjectobligatorisk

Visa egenskaper

codestringobligatorisk

messagestringobligatorisk

retryablebooleanobligatorisk

Anrop

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

Svar

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