تأكيد رفع صورة كبيانات ثنائية

أكد واصف الرفع mediaImport الذي سبق تحضيره، مع إرسال البايتات الأصلية لملف JPEG أو PNG أو WebP (بحد أقصى 3,145,728 بايت). يجب أن يطابق طول البيانات بالبايت وقيمة SHA-256 ما في الواصف. لمراجع الملفات أو الملفات المحلية الأكبر، استخدم أدوات الوسائط الموثقة وسير العمل للرفع متعدد الأجزاء في SDK.

POST/api/v1/media/import

التفويض

Authorizationرمز Bearer · headerمطلوب

مفتاح API من Influence بصلاحيات محددة، أو رمز وصول OAuth مدعوم. لا تدرج بيانات الاعتماد في عناوين URL أو مدخلات الأدوات.

معاملات الترويسة

X-Publish-ConfirmationConfirmationCapabilityمطلوب

قيمة confirmationCapability نفسها التي أعادتها prepare. أرسلها في هذه الترويسة فقط، مع المدخلات نفسها، قبل expiresAt.

الطول الأدنى: 32 · الطول الأقصى: 4096 · يطابق ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyمطلوب

معرف لإعادة المحاولة ينشئه المستدعي. احتفظ بهذا المفتاح وقيمة confirmationCapability والمدخلات بعد أي استجابة غير مؤكدة.

الطول الأدنى: 16 · الطول الأقصى: 200 · يطابق ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringمطلوب

القيمة encodeURIComponent(JSON.stringify(upload)) من مدخلات mediaImport المحضرة. يتبع الكائن بعد فك الترميز البنية BinaryUploadDescriptor؛ ويبلغ الحد الأقصى للترويسة المرمزة 4,096 محرفا.

الطول الأقصى: 4096

محتوى الطلب

مطلوبapplication/octet-stream

string<binary>

الاستجابات

200

نتيجة الوسائط؛ راجع ok وحالة عنصر الوسائط.

واحد فقط مما يلي:

object

okbooleanمطلوب

outputJsonValue | nullمطلوب

عرض الخصائص

واحد أو أكثر مما يلي:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

مصفوفة من JsonValue

مرجع دائري إلى JsonValue.

object

object

toolNamestringمطلوب

القيم المسموح بها:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

القيم المسموح بها:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

400

الطلب غير صالح. معاملات الاستعلام غير مقبولة. قد ترد أخطاء التحقق الخاصة بالأداة ضمن استجابة خطأ للأداة.

واحد أو أكثر مما يلي:

TransportError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

ToolError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

401

بيانات اعتماد Bearer غير موجودة أو غير صالحة أو منتهية الصلاحية.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

403

بيانات الاعتماد لا تتضمن الصلاحيات المطلوبة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

404

واجهة API المخصصة للبرامج أو الأداة المطلوبة غير متاحة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

413

يتجاوز الطلب الحد الأقصى للبايتات.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

429

جرى تجاوز حد معدل الطلبات. يمكن إعادة المحاولة بعد هذا الخطأ.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

503

واجهة API أو خدمة التنفيذ التي تعتمد عليها غير متاحة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

الطلب

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

الاستجابة

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