Konfirmasikan unggahan gambar biner

Konfirmasikan deskriptor unggahan yang disiapkan melalui mediaImport dengan byte JPEG, PNG, atau WebP asli (maksimal 3145728 byte). Panjang dan SHA-256 harus sesuai dengan deskriptor. Untuk referensi file atau file lokal yang lebih besar, gunakan tool media dan alur unggahan multipart SDK.

POST/api/v1/media/import

Otorisasi

AuthorizationToken Bearer · headerwajib

Kunci API Influence dengan izin terbatas atau token akses OAuth yang didukung. Jangan sertakan kredensial dalam URL atau input tool.

Parameter header

X-Publish-ConfirmationConfirmationCapabilitywajib

Nilai confirmationCapability persis seperti yang dikembalikan prepare. Kirim hanya melalui header ini, dengan input yang sama, sebelum expiresAt.

panjang min.: 32 · panjang maks.: 4096 · sesuai dengan ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeywajib

Identitas percobaan ulang yang dibuat klien. Simpan kunci, kapabilitas konfirmasi, dan input ini jika hasil respons belum pasti.

panjang min.: 16 · panjang maks.: 200 · sesuai dengan ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringwajib

encodeURIComponent(JSON.stringify(upload)) dari input mediaImport yang sudah disiapkan. Objek hasil dekode mengikuti BinaryUploadDescriptor; header terenkode dibatasi hingga 4096 karakter.

panjang maks.: 4096

Isi permintaan

wajibapplication/octet-stream

string<binary>

Respons

200

Hasil media; periksa ok dan status aset.

Tepat satu dari:

object

okbooleanwajib

output__schema0wajib

Tampilkan properti

__schema0

toolNamestringwajib

Nilai yang diizinkan:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

400

Permintaan tidak valid. Parameter kueri tidak diterima. Kegagalan validasi dapat menggunakan format error tool.

Satu atau lebih dari:

TransportError

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

ToolError

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

401

Kredensial bearer tidak ada, tidak valid, atau kedaluwarsa.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

403

Kredensial tidak memiliki izin yang diperlukan.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

404

API atau tool yang diminta tidak tersedia.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

413

Permintaan melebihi batas byte.

errorobjectwajib

Tampilkan properti

codestringwajib

Nilai yang diizinkan:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwajib

panjang min.: 1 · panjang maks.: 2048

retryablebooleanwajib

okbooleanwajib

toolNamestringwajib

429

Batas permintaan terlampaui. Permintaan dapat dicoba lagi.

errorobjectwajib

Tampilkan properti

codestringwajib

messagestringwajib

retryablebooleanwajib

503

API atau layanan yang menjalankan operasi tidak tersedia.

errorobjectwajib

Tampilkan properti

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