Görselin ikili veriyle yüklenmesini onaylayın

Hazırlanmış bir mediaImport yükleme tanımlayıcısını özgün JPEG, PNG veya WebP baytlarıyla (en fazla 3.145.728 bayt) onaylayın. Bayt uzunluğu ve SHA-256 tanımlayıcıyla eşleşmelidir. Dosya referansları veya daha büyük yerel dosyalar için belgelerdeki medya araçlarını ve SDK çok parçalı aktarım akışını kullanın.

POST/api/v1/media/import

Yetkilendirme

AuthorizationBearer erişim belirteci · headerzorunlu

İzinleri sınırlandırılmış Influence API anahtarı veya desteklenen OAuth erişim belirteci. Kimlik bilgilerini URL’lere veya araç girdisine koymayın.

Üst bilgi parametreleri

X-Publish-ConfirmationConfirmationCapabilityzorunlu

prepare sonucunda dönen confirmationCapability değerini aynen kullanın. expiresAt dolmadan, aynı girdiyle ve yalnızca bu başlıkta gönderin.

alt uzunluk sınırı: 32 · üst uzunluk sınırı: 4096 · şununla eşleşir: ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyzorunlu

Çağrıyı yapanın oluşturduğu yeniden deneme kimliği. Belirsiz bir yanıttan sonra bu anahtarı, onay yetkisini ve girdiyi koruyun.

alt uzunluk sınırı: 16 · üst uzunluk sınırı: 200 · şununla eşleşir: ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringzorunlu

Hazırlanmış mediaImport girdisi için encodeURIComponent(JSON.stringify(upload)) kullanın. Kodlaması çözülen nesne BinaryUploadDescriptor yapısına uyar; kodlanmış başlık en fazla 4.096 karakterdir.

üst uzunluk sınırı: 4096

İstek gövdesi

zorunluapplication/octet-stream

string<binary>

Yanıtlar

200

Medya sonucu; ok alanını ve medya varlığının durumunu inceleyin.

Yalnızca biri:

object

okbooleanzorunlu

outputJsonValue | nullzorunlu

Özellikleri göster

En az biri:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Öğe türü JsonValue olan dizi

Döngüsel başvuru: JsonValue.

object

object

toolNamestringzorunlu

İzin verilen değerler:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

İzin verilen değerler:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

400

Geçersiz istek. Sorgu parametreleri kabul edilmez. Araç doğrulama hataları, araç hata yanıtı yapısında dönebilir.

En az biri:

TransportError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

ToolError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

401

Eksik, geçersiz veya süresi dolmuş bearer kimlik bilgisi.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

403

Kimlik bilgisi gerekli izinlere sahip değil.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

404

Programatik API veya istenen araç kullanılamıyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

413

İstek, bayt sınırını aşıyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

429

İstek sıklığı sınırı aşıldı. Bu hata için yeniden deneme yapılabilir.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

503

API kullanılamıyor veya işlem bağlı sistemde yürütülemiyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

İstek

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

Yanıt

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