Feltöltési link: POST /upload-link

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

Az útvonal

Egy böngészős linket ad vissza, amire a felhasználó ráhúzza a saját gépén vagy telefonján lévő képet vagy videót. A fájl egyenesen a munkaterület médiatárába kerül, a link azonosítójával megjelölve.

Arra az esetre való, amikor a hívónak nincs meg a fájl: egy chatben futó ügynök nem tud átvenni egy 400 MB-os videót, és nyilvános URL-je sincs hozzá. A CLI-nek, amelyik a fájlt a lemezen látja, a /upload végpont az egyszerűbb út.

A link két óráig él, több fájlt is fogad, és bejelentkezés nélkül működik. Csak feltölteni tud abba az egy munkaterületbe, amelyikhez készült: olvasni, posztolni nem.

Kérés

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

Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az OpenAPI dokumentum tartalmazza.

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

Fontos

• Az url a felhasználónak szól: mutasd meg neki szó szerint. Amikor azt mondja, kész, a GET /upload-link/:id adja vissza, mi érkezett.

Kapcsolódó

• Hitelesítés: a kulcs és a scope-ok.
• Hibák és korlátok: a hibaválaszok és a hívási keret.
• Minden végpont: a teljes lista.