Confirmă încărcarea binară a unei imagini

Confirmă un descriptor de încărcare mediaImport pregătit, folosind octeții JPEG, PNG sau WebP originali (cel mult 3.145.728 de octeți). Lungimea în octeți și SHA-256 trebuie să corespundă descriptorului. Pentru referințe la fișiere sau fișiere locale mai mari, folosește instrumentele media documentate și fluxul multipart din SDK.

POST/api/v1/media/import

Autorizare

AuthorizationToken Bearer · headerobligatoriu

Cheie API Influence cu permisiuni limitate sau token de acces OAuth acceptat. Nu include datele de acces în URL-uri sau în datele de intrare ale instrumentelor.

Parametri de antet

X-Publish-ConfirmationConfirmationCapabilityobligatoriu

Valoarea exactă confirmationCapability returnată de prepare. Trimite-o doar în acest antet, cu aceleași date de intrare, înainte de expiresAt.

lungime minimă: 32 · lungime maximă: 4096 · corespunde modelului ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatoriu

Identificator de reîncercare generat de apelant. Păstrează împreună această cheie, permisul și datele de intrare după un răspuns incert.

lungime minimă: 16 · lungime maximă: 200 · corespunde modelului ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringobligatoriu

encodeURIComponent(JSON.stringify(upload)) din datele de intrare mediaImport pregătite. Obiectul decodificat respectă BinaryUploadDescriptor; antetul codificat are cel mult 4.096 de caractere.

lungime maximă: 4096

Corpul cererii

obligatoriuapplication/octet-stream

string<binary>

Răspunsuri

200

Rezultatul media; verifică ok și starea fișierului media.

Exact una dintre variante:

object

okbooleanobligatoriu

outputJsonValue | nullobligatoriu

Afișează proprietățile

Una sau mai multe variante:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Tablou cu elemente de tip JsonValue

Referință circulară la JsonValue.

object

object

toolNamestringobligatoriu

Valori permise:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

Valori permise:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

400

Cerere nevalidă. Parametrii de interogare nu sunt acceptați. Erorile de validare ale instrumentelor pot folosi structura unui răspuns de eroare al instrumentului.

Una sau mai multe variante:

TransportError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

401

Datele de acces bearer lipsesc, sunt nevalide sau au expirat.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

403

Datele de acces nu au permisiunile necesare.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

404

API-ul pentru acces programatic sau instrumentul solicitat nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

413

Cererea depășește limita de octeți.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

429

Limita de frecvență a cererilor a fost depășită. Eroarea permite reîncercarea.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

503

API-ul sau serviciul din amonte care îl execută nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

Cerere

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ăspuns

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