Skip to content

Upload by URL

Base URL https://api.accessful.de/api/v1/upload-service. Every request needs the X-API-Key header — see Authentication.

Hand us URLs and we fetch the PDFs ourselves. Downloads run asynchronously.

POST /pdf/upload-by-url-list
Content-Type: application/json
{
"files": [
{ "url": "https://example.com/report.pdf", "filename": "report.pdf" }
],
"callbackUrl": "https://your-app.example.com/hooks/accessful",
"hmacSignature": "your-webhook-secret"
}
  • filename must match ^[A-Za-z0-9_-]+\.pdf$.
  • hmacSignature (the webhook secret) must match ^[A-Za-z0-9_-]{1,64}$.

202 Accepted

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

Each jobId behaves like a caseId — poll and download with it.