Per URL hochladen

Basis-URL https://api.accessful.de/api/v1/upload-service. Jede Anfrage benötigt den X-API-Key-Header — siehe Authentifizierung.

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

POST /pdf/upload-by-url-list
Content-Type: application/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 und darf höchstens 255 Zeichen enthalten.
hmacSignature (das Webhook-Secret) muss ^[A-Za-z0-9_-]{1,64}$ entsprechen.

202 Accepted

{
  "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.

Zuverlässige URL-Aufträge

Erlaubt sind ausschließlich öffentliche HTTPS-URLs. Redirects und aufgelöste Adressen werden geprüft; interne, Loopback- und Link-Local-Ziele werden abgewiesen. Der Download endet spätestens bei 50 MiB oder 120 Sekunden. Der Inhalt muss ein gültiges PDF sein. Multipart-Limits gelten separat.

Der optionale UUID-Header Idempotency-Key macht die dauerhafte Annahme wiederholbar. Derselbe Accessful-Nutzer, dieselbe Kennung und Eingabe liefern dieselben Auftrags-IDs, auch nach API-Key-Wechsel. Abweichende Eingaben mit derselben Kennung liefern 409. Die Zuordnung bleibt mindestens 24 Stunden und solange Aufträge laufen bestehen. Bestehende Clients dürfen den Header weglassen. Speichere die Kennung vor dem Aufruf; ein Timeout belegt keine Ablehnung.

Ein angenommener Auftrag ist für seinen Eigentümer sofort als queued abfragbar. Download- und Validierungsfehler führen zu failed. Ein Duplikat führt zu failed mit error.code: DUPLICATE_FILE und eigener existingCaseId; der Auftrag wird nicht stillschweigend übersprungen.

Quell-URLs dürfen keine eingebetteten Zugangsdaten oder Fragmente enthalten. Ungültige URL-Syntax oder ein ungültiger Idempotency-Key ergibt vor der Annahme 400. Bei Wiederholungen mit demselben Key müssen URL und übrige Eingaben unverändert bleiben; eine erneuerte signierte Quell-URL ändert die Anfrage.