Sahkan muat naik imej binari

Sahkan deskriptor muat naik yang disediakan melalui mediaImport dengan bait JPEG, PNG atau WebP asal (maksimum 3145728 bait). Panjang dan SHA-256 mesti sepadan dengan deskriptor. Untuk rujukan fail atau fail setempat yang lebih besar, gunakan alat media dan aliran muat naik berbilang bahagian SDK.

POST/api/v1/media/import

Kebenaran akses

AuthorizationToken Bearer · headerwajib

Kunci API Influence dengan kebenaran terhad atau token akses OAuth yang disokong. Jangan letakkan kelayakan akses dalam URL atau input alat.

Parameter pengepala

X-Publish-ConfirmationConfirmationCapabilitywajib

Nilai confirmationCapability tepat seperti yang dikembalikan oleh prepare. Hantar hanya melalui pengepala ini, dengan input yang sama, sebelum expiresAt.

panjang minimum: 32 · panjang maksimum: 4096 · sepadan dengan ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeywajib

Pengenal cubaan semula yang dijana oleh klien. Simpan kunci, keupayaan pengesahan dan input ini jika hasil respons tidak pasti.

panjang minimum: 16 · panjang maksimum: 200 · sepadan dengan ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringwajib

encodeURIComponent(JSON.stringify(upload)) daripada input mediaImport yang telah disediakan. Objek yang dinyahkod mengikut BinaryUploadDescriptor; pengepala yang dikodkan dihadkan kepada 4096 aksara.

panjang maksimum: 4096

Badan permintaan

wajibapplication/octet-stream

string<binary>

Respons

200

Hasil media; semak ok dan status aset.

Tepat satu daripada:

object

okbooleanwajib

output__schema0wajib

Paparkan sifat

__schema0

toolNamestringwajib

Nilai yang dibenarkan:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectwajib

Paparkan sifat

codestringwajib

Nilai yang dibenarkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang minimum: 1 · panjang maksimum: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

400

Permintaan tidak sah. Parameter pertanyaan tidak diterima. Kegagalan pengesahan input boleh menggunakan format ralat alat.

Satu atau lebih daripada:

TransportError

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

ToolError

errorobjectwajib

Paparkan sifat

codestringwajib

Nilai yang dibenarkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang minimum: 1 · panjang maksimum: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

401

Kelayakan bearer tiada, tidak sah atau telah tamat tempoh.

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

403

Kelayakan akses tidak mempunyai kebenaran yang diperlukan.

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

404

API atau alat yang diminta tidak tersedia.

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

413

Permintaan melebihi had bait.

errorobjectwajib

Paparkan sifat

codestringwajib

Nilai yang dibenarkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang minimum: 1 · panjang maksimum: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

429

Had permintaan telah dilampaui. Permintaan boleh dicuba semula.

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

503

API atau perkhidmatan yang menjalankan operasi tidak tersedia.

errorobjectwajib

Paparkan sifat

codestringwajib

messagestringwajib

retryablebooleanwajib

Permintaan

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

Respons

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