Zum Hauptinhalt springen
GET
/
v1
/
files
/
{file_id}
Dateimetadaten nach ID abrufen
curl --request GET \
  --url https://api.olostep.com/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "filename": "<string>",
  "bytes": 123,
  "purpose": "<string>",
  "status": "<string>"
}

Übersicht

Verwende diesen Endpunkt, um Metadaten für eine bestimmte Datei abzurufen, indem du ihre eindeutige ID angibst. Dies kann nützlich sein, um Dateiinformationen wie Name, Größe und Erstellungsdatum zu überprüfen.

Anfrage

HTTP-Anfrage

GET /v1/files/{file_id}

Pfadparameter

ParameterTypBeschreibung
file_idstringDie eindeutige ID der Datei.

Antwort

Bei Erfolg gibt dieser Endpunkt eine JSON-Antwort mit den Metadaten der Datei zurück.

Erfolgreiche Antwort

{
  "id": "string",
  "name": "string",
  "size": "integer",
  "created_at": "string"
}

Fehler

404 Datei nicht gefunden

Wenn die angegebene file_id nicht existiert, wird ein 404-Fehler zurückgegeben.

Beispiel

Anfrage

GET /v1/files/12345

Antwort

{
  "id": "12345",
  "name": "example.txt",
  "size": 1024,
  "created_at": "2023-01-01T12:00:00Z"
}
Nutze diesen Endpunkt, um schnell auf die Metadaten einer Datei zuzugreifen, die du in deinem Projekt benötigst.

Autorisierungen

Authorization
string
header
erforderlich

Bearer-Authentifizierungsheader in der Form Bearer , wobei dein Authentifizierungstoken ist.

Pfadparameter

file_id
string
erforderlich

Eindeutiger Bezeichner für die Datei, die abgerufen werden soll.

Antwort

Erfolgreiche Antwort mit Dateimetadaten.

id
string

Datei-ID

object
string

Die Art des Objekts. "file" für diesen Endpunkt.

created
integer

Erstellter Epoch-Zeitstempel

filename
string

Der Dateiname der hochgeladenen Datei

bytes
integer

Dateigröße in Bytes

purpose
string

Der Zweck der Datei

status
string

Dateistatus (z.B. 'pending', 'completed')