אישור העלאה בינארית של תמונה

אשרו מתאר העלאה שהוכן ל־mediaImport עם הבתים המקוריים של קובץ JPEG, PNG או WebP (עד 3,145,728 בתים). אורך התוכן בבתים וערך SHA-256 חייבים להתאים למתאר. להפניות לקבצים או לקבצים מקומיים גדולים יותר, השתמשו בכלי המדיה המתועדים ובתהליך העבודה להעלאה מסוג multipart ב־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חובה

מזהה לניסיון חוזר שנוצר בצד הלקוח. לאחר תגובה לא ודאית, שמרו על אותו מפתח, אותו ערך אישור ואותו קלט.

אורך מזערי: 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
  }
}