Upload-Link: POST /upload-link

Böngészős feltöltési link, ha a fájl a felhasználó eszközén van.

Der Pfad

Gibt einen Browser-Link zurück, auf den der Nutzer ein Bild oder Video von seinem Rechner oder Handy zieht. Die Datei landet direkt in der Mediathek des Arbeitsbereichs, markiert mit der Link-ID.

Dafür gedacht, wenn der Aufrufer die Datei nicht hat: Ein Agent im Chat kann ein 400-MB-Video nicht entgegennehmen, und eine öffentliche URL gibt es auch nicht. Für die CLI, die die Datei auf der Festplatte sieht, ist der Endpunkt /upload der einfachere Weg.

Der Link gilt zwei Stunden, nimmt mehrere Dateien entgegen und funktioniert ohne Anmeldung. Hochladen kann er nur in den einen Arbeitsbereich, für den er erstellt wurde: lesen oder posten nicht.

Anfrage

curl -X POST https://api.posty.hu/public/v1/upload-link \
  -H "Authorization: psty_a_kulcsod"

Antwort

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

{
  "id": "kR3mQ7xP2nLa",
  "url": "https://posty.hu/feltoltes/eyJhbGciOi…",
  "expiresAt": "2026-09-08T14:00:00.000Z"
}

Wichtig

• Die url ist für den Nutzer: zeig sie ihm wortwörtlich. Wenn er sagt, er ist fertig, gibt GET /upload-link/:id zurück, was angekommen ist.

Siehe auch

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