Documentation

Le contrat d’intégration

De la clé API au PDF/UA en trois étapes prévisibles

Une URL de base, un en-tête d’authentification et un identifiant de dossier relient tout le flux.

1. 01POST/pdf/upload

   Téléverser

   Envoyez un ou plusieurs PDF et recevez un caseId pour chaque fichier accepté.

   Ouvrir la documentation de l’endpoint
2. 02GET/job-status/{caseId}

   Suivre

   Suivez un cycle clair de queued à running jusqu’à un statut final.

   Ouvrir la documentation de l’endpoint
3. 03GET/download/{caseId}

   Télécharger

   Récupérez le document corrigé sous forme de réponse application/pdf standard.

   Ouvrir la documentation de l’endpoint

Copiez, exécutez, intégrez

Votre premier téléversement est prêt

Choisissez votre stack. Chaque exemple appelle le même endpoint et renvoie l’identifiant utilisé par le reste de l’API.

• Définir ACCESSFUL_API_KEY
• Placer document.pdf dans le répertoire de travail
• Exécuter l’exemple et conserver successfulUploads[0]

Continuer avec le démarrage rapide complet

first-upload API

cURLNode.jsPython

: "${ACCESSFUL_API_KEY:?Set ACCESSFUL_API_KEY first}"

curl --fail-with-body \
  -X POST "https://api.accessful.de/api/v1/upload-service/pdf/upload" \
  -H "X-API-Key: $ACCESSFUL_API_KEY" \
  -F "files=@document.pdf"

import { openAsBlob } from 'node:fs';

const apiKey = process.env.ACCESSFUL_API_KEY;
if (!apiKey) throw new Error('Set ACCESSFUL_API_KEY first');

const file = await openAsBlob('document.pdf', {
  type: 'application/pdf',
});
const body = new FormData();
body.append('files', file, 'document.pdf');

const response = await fetch(
  'https://api.accessful.de/api/v1/upload-service/pdf/upload',
  {
    method: 'POST',
    headers: { 'X-API-Key': apiKey },
    body,
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

# pip install requests
import os
import requests

url = "https://api.accessful.de/api/v1/upload-service/pdf/upload"
headers = {"X-API-Key": os.environ["ACCESSFUL_API_KEY"]}

with open("document.pdf", "rb") as pdf:
    response = requests.post(
        url,
        headers=headers,
        files={"files": ("document.pdf", pdf, "application/pdf")},
        timeout=60,
    )

response.raise_for_status()
print(response.json())

200 OKsuccessfulUploads[0] → caseId

Choisissez la prochaine étape

De la première requête à la production sans chercher partout

Chaque parcours part de votre besoin actuel et mène directement au bon niveau de détail.

Démarrage rapide

Exécutez téléversement → statut → téléchargement de bout en bout.

Ouvrir le démarrage rapide

Testeur d’API

Convertissez un vrai PDF dans le navigateur avec votre propre clé.

Tester en direct

Référence API

Consultez chaque endpoint, champ, réponse et code de statut.

Voir les endpoints

Webhooks

Remplacez le polling par des callbacks signés et événementiels.

Configurer les webhooks

Documentation prête pour les agents

Vous développez avec un agent de programmation IA ?

Installez le skill Accessful versionné pour que votre agent comprenne l’intégralité du contrat API sans approximation.

Télécharger le skill d’agent