Le pipeline de correction, sous forme d’API.

La même correction que celle effectuée par l’application web a11yfy est disponible via une API REST standard : envoyez un PDF et recevez en retour un document balisé et validé selon la norme PDF/UA-1 — en un seul appel, depuis n’importe quel langage ou stack.

Comment l’intégrer à votre pile technologique

  • Au moment du téléchargement — corrigez les documents dès que vos utilisateurs ou vos systèmes les publient.
  • Par lots — traitez un arriéré dossier par dossier, avec la même tarification à la page.
  • Dans votre produit — renvoyez le même fichier PDF/UA-1 et le même rapport détaillé par problème à vos propres utilisateurs, via votre propre interface utilisateur.

Le processus

  1. POST /v1/jobs — envoyez un PDF sous forme de fichier multipart, éventuellement accompagné d’une webhook_url. Vous recevez immédiatement un job_id. Le serveur exécute alors automatiquement l’intégralité du pipeline — diagnostic, balisage ou reconstruction complète, puis validation — et débite les crédits requis par le document.
  2. Suivi de l’état — interrogez GET /v1/jobs/{id}, ou, si vous avez fourni un webhook_url, recevez une notification signée dès que la tâche atteint un état final.
  3. GET /v1/jobs/{id}/result — téléchargez le fichier de sortie balisé PDF/UA-1 et son rapport de validation au niveau des éléments.

Pour intégrer votre propre système de facturation et de suivi, utilisez les points de terminaison GET /v1/balance (solde de crédits) et GET /v1/usage (utilisation).

SDK officiels : Python et npm

Si vous préférez ne pas écrire les appels HTTP à la main, utilisez les bibliothèques clientes officielles — toutes deux sont de fines surcouches typées de l’API v1 décrite ci-dessus :

Les deux SDK sont open source : github.com/a11yfy/sdk.

Pourquoi l’intégrer à votre propre système

  • REST indépendant du langage. Aucun SDK requis : un seul appel HTTP depuis n’importe quel langage — envoyez le fichier au format multipart/form-data.
  • Asynchrone, avec webhooks. Pas besoin d’interroger le serveur : votre propre workflow se déclenche en fonction de l’état final, et la notification est signée cryptographiquement.
  • Soumission idempotente. Renvoyer accidentellement le même fichier n’entraîne jamais de double facturation.
  • Registre partagé. Les clés API sont valables au niveau de l’équipe ; l’utilisation apparaît dans le même budget d’espace de travail que les téléchargements Web.
  • Traitement dans l’UE, suppression automatique. Les données d’entrée sont supprimées après 7 jours, les données de sortie après 30 jours — sans aucune intervention de votre part.

Remarques pratiques

  • L’API v1 répond en anglais ; la gestion de la langue du document (texte alternatif, métadonnées) suit celle du document lui-même, et non la langue de l’API.
  • Les tarifs correspondent à ceux du site web : la réparation technique et la reconstruction complète sont facturées à la page, selon le profil du document.

Référence de l’API → · Tarifs →