> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datei abrufen

> Metadaten für eine Datei anhand ihrer ID abrufen.

## Ü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

| Parameter | Typ    | Beschreibung                 |
| --------- | ------ | ---------------------------- |
| `file_id` | string | Die eindeutige ID der Datei. |

## Antwort

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

### Erfolgreiche Antwort

```json theme={null}
{
  "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

```http theme={null}
GET /v1/files/12345
```

### Antwort

```json theme={null}
{
  "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.


## OpenAPI

````yaml de/openapi/files.json GET /v1/files/{file_id}
openapi: 3.0.3
info:
  title: Dateien-API
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/files/{file_id}:
    get:
      summary: Dateimetadaten nach ID abrufen
      description: Metadaten für eine Datei anhand ihrer ID abrufen.
      parameters:
        - name: file_id
          in: path
          required: true
          description: Eindeutiger Bezeichner für die abzurufende Datei.
          schema:
            type: string
      responses:
        '200':
          description: Erfolgreiche Antwort mit Dateimetadaten.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Datei-ID
                  object:
                    type: string
                    description: Die Art des Objekts. "file" für diesen Endpunkt.
                  created:
                    type: integer
                    description: Erstellter Epoch-Zeitstempel
                  filename:
                    type: string
                    description: Der Dateiname der hochgeladenen Datei
                  bytes:
                    type: integer
                    description: Dateigröße in Bytes
                  purpose:
                    type: string
                    description: Der Zweck der Datei
                  status:
                    type: string
                    description: Dateistatus (z.B. 'pending', 'completed')
        '401':
          description: Ungültiger API-Schlüssel
        '404':
          description: Datei nicht gefunden
        '500':
          description: Interner Serverfehler
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer-Authentifizierungsheader in der Form Bearer <token>, wobei
        <token> dein Authentifizierungstoken ist.

````