# Signierte Download-URL

**POST** `/v1/utils/S3signedGetURL`

Erzeugt temporäre vorsignierte GET-URLs zum Anzeigen oder Herunterladen privater Cloud-Ressourcen.

Dieser Endpunkt ist für eine vorhandene private Datei vorgesehen. Er lädt keine Dateidaten hoch und darf nicht zum Anfordern einer Upload-URL verwendet werden.

### Anfrageinhalt

```json
{
  "urls": [
    {
      "url": "https://tradly-paas-private.s3.amazonaws.com/tenant/user/file.pdf",
      "downloadable": true
    }
  ]
}
```

`urls` muss mindestens ein Objekt mit `url` enthalten. `downloadable` ist optional. Bei `true` fordert die Antwort den Browser zum Herunterladen der Datei auf. Eine Eigenschaft `mime` ist weder erforderlich noch wird sie von diesem Endpunkt verwendet.

Für neue Uploads verwenden Sie `POST /v1/utils/S3signedUploadURL` mit einem `files`-Array aus Objekten `{ "name", "type" }`.

### cURL

```bash
curl -X POST "$API/v1/utils/S3signedGetURL" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  --data-raw '{"urls":[{"url":"https://tradly-paas-private.s3.amazonaws.com/tenant/user/file.pdf"}]}'
```

### Antwortfelder

**result** Array temporärer vorsignierter, zugänglicher URLs.