# Per URL hochladen

Basis-URL `https://api.accessful.de/api/v1/upload-service`. Jede Anfrage benötigt den `X-API-Key`-Header — siehe [Authentifizierung](https://docs.accessful.de/de/authentication/).

Übergib uns URLs, wir holen die PDFs selbst. Die Downloads laufen asynchron.

```http
POST /pdf/upload-by-url-list
Content-Type: application/json
```

```json
{
  "files": [
    { "url": "https://example.com/report.pdf", "filename": "report.pdf" }
  ],
  "callbackUrl": "https://deine-app.example.com/hooks/accessful",
  "hmacSignature": "dein-webhook-secret"
}
```

- `filename` muss `^[A-Za-z0-9_-]+\.pdf$` entsprechen.
- `hmacSignature` (das Webhook-Secret) muss `^[A-Za-z0-9_-]{1,64}$` entsprechen.

**`202 Accepted`**

```json
{
  "accepted": [
    { "uri": "https://example.com/report.pdf", "jobId": "7c2f1e4a-…", "filename": "report.pdf" }
  ],
  "failures": {},
  "callbackResult": null
}
```

Jede `jobId` verhält sich wie eine `caseId` — damit pollen und herunterladen.