API ProRéservé au palier Pro

Authentification

Créez une clé depuis votre espace compte (rubrique API). Elle commence par efp_live_ et n'est affichée qu'une seule fois : nous n'en conservons qu'une empreinte. Envoyez-la dans l'en-tête Authorization de chaque requête.

Traitez cette clé comme un mot de passe : jamais dans du code côté navigateur, jamais dans un dépôt public. Vous pouvez la révoquer à tout moment ; une clé révoquée cesse de fonctionner immédiatement.

Authorization: Bearer efp_live_XXXXXXXXXXXXXXXX

Outils disponibles

Chaque outil est désigné par son identifiant, le même que dans notre registre. Les outils qui s'exécutent dans le navigateur sur le site sont exécutés sur nos serveurs lorsqu'ils sont appelés par l'API. Les paramètres de chaque outil reprennent les options de sa page.

Créer une tâche

Déclarez l'outil, ses paramètres et la liste des fichiers (nom, taille en octets, type MIME). Les limites de votre compte sont vérifiées à ce moment-là : en cas de dépassement, la réponse explique la limite atteinte. Le quota n'est définitivement consommé que si la tâche aboutit.

curl -X POST "https://eflypdf.com/api/v1/jobs" \
  -H "Authorization: Bearer efp_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "compress",
    "params": { "mode": "recommended" },
    "files": [{ "name": "rapport.pdf", "size": 2483021, "mime": "application/pdf" }]
  }'

{
  "jobId": "4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10",
  "uploads": [
    { "path": "…/4f6c1d2e…/0-rapport.pdf", "signedUrl": "https://…", "token": "…" }
  ]
}

Téléverser les fichiers

Envoyez chaque fichier sur l'URL signée correspondante, dans l'ordre de la liste. Ces URL expirent rapidement : téléversez juste après la création. Chaque fichier est analysé par un antivirus avant traitement.

curl -X PUT "<signedUrl>" \
  -H "Content-Type: application/pdf" \
  --data-binary @rapport.pdf

Lancer et suivre la tâche

Une fois les fichiers téléversés, lancez la tâche. Elle passe par les états queued, running, puis succeeded ou failed. Interrogez-la à intervalle raisonnable (toutes les 2 à 5 secondes) ou, mieux, abonnez-vous aux webhooks.

Les tâches de l'API bénéficient de la priorité haute du palier Pro dans la file d'attente.

curl -X POST "https://eflypdf.com/api/v1/jobs/4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10/start" \
  -H "Authorization: Bearer efp_live_XXXXXXXXXXXXXXXX"

curl "https://eflypdf.com/api/v1/jobs/4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10" \
  -H "Authorization: Bearer efp_live_XXXXXXXXXXXXXXXX"

{
  "id": "4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10",
  "tool": "compress",
  "status": "succeeded",
  "progress": 100,
  "error": null,
  "expiresAt": "2026-10-21T15:00:00Z"
}

Télécharger le résultat

Le point d'entrée de téléchargement répond par une redirection vers une URL signée temporaire. Le résultat reste disponible pendant la durée de conservation de votre palier, puis il est supprimé automatiquement avec les fichiers sources.

curl -L "https://eflypdf.com/api/v1/jobs/4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10/download" \
  -H "Authorization: Bearer efp_live_XXXXXXXXXXXXXXXX" \
  -o resultat.pdf

Webhooks signés

Déclarez une URL HTTPS dans votre espace compte et choisissez les événements (job.done, job.failed). Chaque envoi porte l'en-tête X-Signature : t est l'horodatage Unix, v1 la signature HMAC-SHA256, en hexadécimal, de la chaîne « t.corps_brut » calculée avec le secret du webhook.

Vérifiez toujours la signature et rejetez les messages trop anciens. Répondez par un code 2xx en moins de 10 secondes ; en cas d'échec, l'envoi est retenté plusieurs fois avec un délai croissant. Un même événement peut arriver deux fois : dédoublonnez sur son identifiant.

POST https://votre-serveur.example/webhooks
X-Signature: t=1792335600,v1=5f2b…c9e1
Content-Type: application/json

{
  "event": "job.done",
  "jobId": "4f6c1d2e-8a0b-4c7e-9d51-2b8f0e3a9c10",
  "tool": "compress",
  "status": "done",
  "errorCode": null,
  "createdAt": "2026-10-19T15:00:00Z"
}

import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(rawBody: string, header: string, secret: string, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false;
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  const given = Buffer.from(parts.v1 ?? "", "hex");
  return given.length === 32 && timingSafeEqual(given, Buffer.from(expected, "hex"));
}

Quotas et limites

L'API ne dispose pas d'un quota séparé : elle consomme exactement les mêmes compteurs que votre compte Pro sur le site (pages IA, mots de traduction, taille des fichiers, lots). Les valeurs ci-dessous sont lues dans notre configuration en vigueur.

Une limitation de débit protège le service : au-delà du nombre de requêtes autorisé par minute, la réponse est 429. Attendez quelques secondes avant de réessayer.

Erreurs

Les erreurs suivent les codes HTTP usuels : 400 (requête invalide), 401 (clé absente ou révoquée), 402 (limite de palier atteinte), 404 (tâche inconnue), 429 (débit ou quota du jour), 503 (assistant temporairement indisponible : rien n'est décompté). Les refus de limite portent un code explicite.

HTTP/1.1 402 Payment Required
{
  "error": "limit",
  "refused": { "code": "AI_PAGES_EXHAUSTED", "max": 2000, "current": 2000, "resetAt": "2026-11-03T00:00:00Z", "upgradeTo": null }
}