Medien

Lädt ein Bild zu Cloudflare Images hoch und legt es in der Medienbibliothek an, wie das Hochladen unter Assets, Bilder in der App. Danach steht es dort mit Name und Art (Bild, Logo, Icon) bereit, url ist sofort öffentlich abrufbar. Kostet keine Credits. Jeder Aufruf legt ein neues Bild an.

Genau eines von source_url oder data angeben:

• source_url: öffentliche https-Adresse der Bilddatei. Cloudflare holt die Datei selbst ab, dealsky lädt nichts herunter. Adressen mit IP statt Hostname, mit Zugangsdaten, localhost, .local und .internal werden abgelehnt. Typ und Größe prüft Cloudflare beim Abholen (höchstens 10 MB); ist die Datei kein Bild, zu groß oder nicht erreichbar, kommt 422 mit dem Grund. Der empfohlene Weg für alles über etwa 700 KB.

• data: Base64 oder data-URL (data:image/png;base64,…). Weil der ganze Body höchstens 1 MB groß sein darf, passen so Bilder bis etwa 700 KB. Der Typ wird am Dateiinhalt erkannt (JPEG, PNG, WebP, SVG wie in der App, kein GIF); ein abweichender content_type wird abgelehnt. SVG mit Skripten, Event-Attributen (onload= …), javascript:-Links oder eingebetteten Inhalten wird abgelehnt.

category wie in der App: logos, icons, images oder pictures. Profilbilder (Avatar) gehören zu einer Person und gehen nicht über die API.

Mit Test-Key wird alles geprüft (Felder, Adresse, Typ, Größe), aber nichts hochgeladen und nichts angelegt.

Genau eines von source_url oder data.

Bilder, Logos, Icons, Videos und Sprachnachrichten aus der Medienbibliothek, wie sie in der App unter Assets (Videos und Bilder, Sprachnachrichten) stehen, neueste zuerst. Gelöschte Einträge fehlen wie in der App. Landingpage-Vorlagen stehen nicht hier, sondern unter GET /v1/landing-page-templates. Von dealsky mitgelieferte System-Videos, die die App zusätzlich zeigt, liefert die API nicht.

Filter: kind fasst die Typen zusammen: image (image, logo, icon), video (static_video und die älteren hauptvideo, sprachsync_video, video; dealsky behandelt sie seit September 2026 als eine Videoart), audio (audio, voice). type filtert auf einzelne Typen. Beides kommagetrennt, z. B. kind=image,audio. q sucht im Namen.

Sichtbarkeit wie in der App: Mit dem Recht outreach sieht die Person, der der Key gehört, alles. Mit nur outreach.videos (Mitarbeiter, die eigene Videos aufnehmen) sieht sie nur Videos und davon nur die eigenen. Fragt so ein Key ausdrücklich nach Bildern oder Audio, kommt 403 mit details.required_permission = "outreach".

url ist die öffentliche Adresse, mit der die App die Datei zeigt oder abspielt. Speicherpfade und interne Angaben gibt die API nicht heraus.

Ein Eintrag der Medienbibliothek mit denselben Feldern wie in der Liste. 404, wenn es die ID im Konto nicht gibt, der Eintrag gelöscht ist oder keine Mediendatei ist (eine Landingpage-Vorlage steht unter GET /v1/landing-page-templates/{id}). Mit nur dem Recht outreach.videos ergeben fremde Videos 404 und Bilder oder Sprachnachrichten 403 mit details.required_permission = "outreach", wie in der App.

Entfernt ein Bild, Video oder eine Sprachnachricht aus der Medienbibliothek. Danach fehlt es in jeder Auswahl der App und in GET /v1/media. Die Datei selbst bleibt erhalten, darum zeigen ältere Nachrichten, Landingpages und Vorlagen weiter darauf. Kostet nichts.

Wird das Medium noch verwendet, bleibt es stehen und es kommt 409 mit details.used_by (Liste aus type, id, name). Geprüft wird wie in der App: Videos in laufenden oder pausierten Kampagnen (als Sprecher-Video) und aktiven Landingpages, Sprachnachrichten in laufenden Kampagnen, Bilder als Logo in Landingpages oder als Firmenlogo. Vorlagen sperren wie in der App nicht.

Rechte wie in der App: Bilder und Sprachnachrichten nur mit outreach. Mit nur outreach.videos lassen sich eigene Videos entfernen; fremde ergeben 404.

Mit Test-Key wird alles geprüft (auch die Verwendung), aber nichts entfernt.

Erster Schritt für Videos und Sprachnachrichten. Liefert eine vorsignierte Adresse, an die die Datei direkt per HTTP PUT geht (nicht über die API, deren Body auf 1 MB begrenzt ist), wie das Hochladen in der App. Danach r2_path an POST /v1/media/videos bzw. POST /v1/media/audio übergeben. Kostet keine Credits. Erst der zweite Schritt legt etwas in der Bibliothek an.

So geht es weiter: PUT {upload_url} mit genau den Headern aus upload_headers und der Datei als Body, innerhalb von 24 Stunden (expires_at). Antwortet der Speicher mit 200, liegt die Datei bereit.

Erlaubt wie in der App: Video als .mp4 (video/mp4), .mov (video/quicktime) oder .webm (video/webm) bis 1 GB; jedes Video wird danach in MP4 gewandelt. Audio als .m4a oder .mp4 (audio/mp4) bis 20 MB, das Format, das LinkedIn für Sprachnachrichten verlangt. Andere Audio-Formate (MP3, WAV, OGG) wandelt die App beim Hochladen um und wartet darauf; über die API bitte vorher in M4A umwandeln. content_type muss zur Endung von file_name passen, size_bytes ist die Größe der Datei.

Rechte wie in der App: Videos mit outreach.videos (Medienseite), Sprachnachrichten nur mit outreach (Seite Sprachnachrichten). Ohne outreach kommt bei kind=audio 403 mit details.required_permission = "outreach".

Mit Test-Key wird alles geprüft, aber keine Adresse ausgestellt (would_presign).

Zweiter Schritt nach POST /v1/media/uploads mit kind=video und dem PUT der Datei. Startet die Umwandlung in MP4 auf dem Server, wie die App es nach jeder Aufnahme tut (Videos müssen MP4 mit Längenangabe sein, sonst scheitern spätere Video-Nachrichten). Ist sie fertig, steht das Video in der Bibliothek (static_video, wie ein Upload in der App) und es gibt eine Benachrichtigung in der Glocke. Kostet keine Credits.

Antwort 202 mit job_id. Den Stand liefert GET /v1/jobs/{id} (kind video_conversion, braucht das Recht outreach); bei succeeded steht die ID des neuen Videos in result.asset_id. Mit nur dem Recht outreach.videos erscheint das fertige Video in GET /v1/media?kind=video. Die Umwandlung dauert meist unter einer Minute, bei großen Dateien länger.

Die Datei wird beim Start nicht geprüft. Fehlt sie (PUT nicht erfolgt oder abgelaufen), endet der Auftrag mit failed. Ist sie kein lesbares Video, endet die Umwandlung mit einem Fehler; wie bei Aufnahmen in der App legt dealsky die Rohdatei dann nach etwa 15 Minuten ungewandelt als Video an. Das Video wird auf höchstens 720p verkleinert. Ein Vorschaubild setzt die API nicht, das geht in der App.

r2_path muss aus einem eigenen Upload stammen, sonst 400. Für dieselbe Datei startet nur ein Auftrag: läuft er noch oder ist er fertig, kommt 409 mit details.job_id; nach failed ist ein neuer Versuch möglich.

Mit Test-Key wird alles geprüft, aber nichts gestartet.

Zweiter Schritt nach POST /v1/media/uploads mit kind=audio und dem PUT der Datei. Legt die Sprachnachricht in der Bibliothek an, wie das Hochladen unter Assets, Sprachnachrichten in der App. Sie ist sofort in Kampagnen und im Postfach auswählbar. Kostet keine Credits.

r2_path muss aus einem eigenen Audio-Upload stammen (.m4a oder .mp4), sonst 400. Ob die Datei wirklich hochgeladen wurde, prüft die API nicht; bitte erst nach erfolgreichem PUT aufrufen. Dieselbe Datei lässt sich nur einmal anlegen (409 mit details.id).

duration_seconds (Länge, wie die App sie bei Aufnahmen speichert) und size_bytes (füllt size_mb) sind freiwillig. Recht wie die Seite Sprachnachrichten: outreach.

Mit Test-Key wird alles geprüft, aber nichts angelegt.