Fájl tartalmának lekérése

Hogy lehet lekérni egy fájl tartalmát API-n keresztül.

2022.01.12 — Posted by Webb & Flow


Tartalomjegyzék

A fájl tartalmát le lehet kérni a tárolt Base64 formátumban, vagy binárisan.

A Base64 esetén text/plain mime type-al válaszol a backend, bináris formában pedig azzal, ami a fájlhoz el van tárolva.

Mindkét esetben 10 perces (600s) lejárati időt határoz meg a cache control header, így érdemes a lekéréskor egy akármilyen query paraméterben küldeni a fájl lastmoddate mezejének értékét, hogy ha változik a fájl, akkor invalidálja a böngésző cache-t.

Bináris tartalom:

GET /projects/PROJECTID/files/FILEID/content

GET /projects/PROJECTID/files/FILEID/content?v=FILE.LASTMODDATE

Base64 tartalom:

GET /projects/PROJECTID/files/FILEID/base64Content

GET /projects/PROJECTID/files/FILEID/base64Content?v=FILE.LASTMODDATE

Mindkét lekérés a következő válaszokat adhatja:

  • HTTP 200
    • sikeres lekérés, küldi a tartalmat is a kért formában
  • HTTP 403
    • nincs hozzáférése a usernek a fájlhoz, vagy a content mezőhöz
  • HTTP 410
    • nem létezik a fájl, vagy üres a content mezeje