Medien

Medien hochladen: POST /upload

Lädt ein Bild oder Video in die Mediathek hoch, bis 1 GB.

Der Pfad

Methode und Pfad

POSThttps://api.posty.hu/public/v1/upload

Berechtigung

media:write

operationId

uploadMedia

Lädt ein Bild oder Video in die Mediathek des Arbeitsbereichs. Die Antwort enthält die ID und die gehostete URL, die du beim Erstellen des Beitrags übergibst.

Dateien mit gleichem Inhalt fasst der Server zusammen. Dieselbe Datei täglich erneut zu schicken legt also keine neue Zeile und kein neues gespeichertes Objekt an.

Parameter

Name	Ort	Typ	Pflicht	Was es tut
file	Body	multipart/form-data	ja	Die Datei. Bilder höchstens 10 MB (JPEG, PNG, GIF, WEBP, AVIF, BMP, TIFF), Video höchstens 1 GB (MP4).

Anfrage

curl -X POST https://api.posty.hu/public/v1/upload \
  -H "Authorization: psty_dein_schluessel" \
  -F "[email protected]"

Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im OpenAPI-Dokument.

{
  "id": "cmd1a2b3c4d5",
  "path": "https://uploads.posty.hu/2026/09/bild.png"
}

Siehe auch

Authentifizierung: der Schlüssel und die Scopes.
Fehler und Limits: die Fehlerantworten und das Aufruflimit.
Alle Endpunkte: die vollständige Liste.

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [email protected] oder nutze auf der Hilfeseite das Formular.