Binären Bild-Upload bestätigen

Bestätige einen mit mediaImport vorbereiteten Upload-Deskriptor mit den ursprünglichen JPEG-, PNG- oder WebP-Bytes (höchstens 3145728 Bytes). Länge und SHA-256 müssen zum Deskriptor passen. Nutze für Dateiverweise oder größere lokale Dateien die dokumentierten Medien-Tools und den mehrteiligen Upload des SDK.

POST/api/v1/media/import

Autorisierung

AuthorizationBearer-Token · headererforderlich

Influence-API-Schlüssel mit begrenzten Berechtigungen oder unterstütztes OAuth-Zugriffstoken. Zugangsdaten gehören weder in URLs noch in Tool-Eingaben.

Header-Parameter

X-Publish-ConfirmationConfirmationCapabilityerforderlich

Der von prepare zurückgegebene confirmationCapability-Wert, unverändert. Sende ihn nur in diesem Header, mit derselben Eingabe und vor expiresAt.

min. Länge: 32 · max. Länge: 4096 · entspricht ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyerforderlich

Vom Client erzeugte Kennung für erneute Versuche. Bewahre diesen Schlüssel, die Bestätigungsberechtigung und die Eingabe bei ungewissem Ergebnis auf.

min. Länge: 16 · max. Länge: 200 · entspricht ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringerforderlich

encodeURIComponent(JSON.stringify(upload)) aus der vorbereiteten mediaImport-Eingabe. Das dekodierte Objekt entspricht BinaryUploadDescriptor; der kodierte Header darf höchstens 4096 Zeichen enthalten.

max. Länge: 4096

Anfrageinhalt

erforderlichapplication/octet-stream

string<binary>

Antworten

200

Medienergebnis; prüfe ok und den Status der Datei.

Genau eines von:

object

okbooleanerforderlich

output__schema0erforderlich

Eigenschaften anzeigen

__schema0

toolNamestringerforderlich

Zulässige Werte:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

Zulässige Werte:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringerforderlich

min. Länge: 1 · max. Länge: 2048

retryablebooleanerforderlich

okbooleanerforderlich

toolNamestringerforderlich

400

Ungültige Anfrage. Abfrageparameter werden nicht akzeptiert. Validierungsfehler können im Fehlerformat des Tools zurückgegeben werden.

Mindestens eines von:

TransportError

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

ToolError

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

Zulässige Werte:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringerforderlich

min. Länge: 1 · max. Länge: 2048

retryablebooleanerforderlich

okbooleanerforderlich

toolNamestringerforderlich

401

Bearer-Zugangsdaten fehlen, sind ungültig oder abgelaufen.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

403

Den Zugangsdaten fehlen erforderliche Berechtigungen.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

404

Die API oder das angeforderte Tool ist nicht verfügbar.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

413

Die Anfrage überschreitet das Byte-Limit.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

Zulässige Werte:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringerforderlich

min. Länge: 1 · max. Länge: 2048

retryablebooleanerforderlich

okbooleanerforderlich

toolNamestringerforderlich

429

Anfragelimit überschritten. Ein erneuter Versuch ist möglich.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

503

Die API oder der ausführende Dienst ist nicht verfügbar.

errorobjecterforderlich

Eigenschaften anzeigen

codestringerforderlich

messagestringerforderlich

retryablebooleanerforderlich

Anfrage

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

Antwort

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