Démarrage rapide

Voici le cycle complet avec curl. Il vous faut une clé API et un PDF. Exportez d’abord la clé :

export ACCESSFUL_API_KEY="ak_votre_cle_ici"
export BASE="https://api.accessful.de/api/v1/upload-service"

1. Téléversez le PDF. Envoyez-le comme champ multipart files :

   curl -X POST "$BASE/pdf/upload" \
     -H "X-API-Key: $ACCESSFUL_API_KEY" \
     -F "files=@document.pdf"

   La réponse liste un caseId par fichier accepté :

   {
     "successfulUploads": ["7c2f1e4a-9b0d-4a1e-8f3c-2d6b5a9e1c40"],
     "duplicateFiles": [],
     "message": "Upload completed successfully. Uploaded 1 files. 0 duplicates found.",
     "callbackUrl": null
   }

2. Interrogez le statut de la tâche avec ce caseId jusqu’à ce qu’il soit completed :

   curl "$BASE/job-status/7c2f1e4a-9b0d-4a1e-8f3c-2d6b5a9e1c40" \
     -H "X-API-Key: $ACCESSFUL_API_KEY"

   { "jobStatus": "completed", "stage": "finished", "score": 87 }

   score est la qualité d’accessibilité du résultat (0–100). Voir toutes les valeurs de jobStatus.

3. Téléchargez le PDF/UA converti :

   curl -L "$BASE/download/7c2f1e4a-9b0d-4a1e-8f3c-2d6b5a9e1c40" \
     -H "X-API-Key: $ACCESSFUL_API_KEY" \
     -o document-pdfua.pdf

4. Supprimez le cas lorsque vous n’en avez plus besoin (facultatif, mais recommandé — il s’agit d’une suppression définitive) :

   curl -X DELETE "$BASE/delete/7c2f1e4a-9b0d-4a1e-8f3c-2d6b5a9e1c40" \
     -H "X-API-Key: $ACCESSFUL_API_KEY"

Sauter l’interrogation

Au lieu de l’étape 2, enregistrez un webhook au moment du téléversement et nous enverrons par POST un événement signé à votre URL dès que la tâche se termine.

Exemple complet

Node.js

const BASE = 'https://api.accessful.de/api/v1/upload-service';
const headers = { 'X-API-Key': process.env.ACCESSFUL_API_KEY };

// 1. Téléverser
const form = new FormData();
form.append('files', new Blob([await readFile('document.pdf')], { type: 'application/pdf' }), 'document.pdf');
const up = await fetch(`${BASE}/pdf/upload`, { method: 'POST', headers, body: form });
const { successfulUploads: [caseId] } = await up.json();

// 2. Interroger jusqu’à l’état terminal
const terminal = new Set(['completed', 'failed', 'analyzer_failed', 'canceled', 'quota_exceeded']);
let status;
do {
  await new Promise((r) => setTimeout(r, 2000));
  status = await (await fetch(`${BASE}/job-status/${caseId}`, { headers })).json();
} while (!terminal.has(status.jobStatus));

if (status.jobStatus !== 'completed') throw new Error(`Job ${status.jobStatus}`);

// 3. Télécharger
const pdf = await (await fetch(`${BASE}/download/${caseId}`, { headers })).arrayBuffer();
await writeFile('document-pdfua.pdf', Buffer.from(pdf));
console.log(`Terminé — score ${status.score}`);

Vous préférez cliquer plutôt que taper ? Exécutez le même flux dans le navigateur sur la page Tester en direct.