Ce que notre API PDF expose : crédits et limites

Les pages API ont tendance à croître plus rapidement que les API. Le nôtre répertorie désormais uniquement les itinéraires qui se terminent sans navigateur : compte, Rédiger et Comparer. C'est délibéré. Un point de terminaison qui ne peut pas terminer son flux de travail est pire que pas de point de terminaison du tout.

Qu'est-ce qui est en direct aujourd'hui

• OBTENIR /v1/moi — le solde créditeur du compte, du plan et du crédit en cours ; 1 crédit par appel.
• POST /v1/redact-pdf - recherchez des modèles, du texte ou des images et renvoyez un PDF expurgé avec apply=1. Gratuit.
• POST /v1/compare-pdf - statistiques, blocs modifiés et différences clés entre deux PDF. Gratuit.

Tous les trois prennent une clé au porteur dans Mon compte. Les résultats sont du JSON avec un lien de téléchargement qui dure deux heures ; les originaux ne sont jamais modifiés sur place.

Ce qui n'est pas dans l'API

Ce que facture l'API aujourd'hui

Seuls trois itinéraires existent : GET /v1/me coûte 1 crédit, tandis que POST /v1/redact-pdf et POST /v1/compare-pdf coûtent 5 crédits chacun. Il n'y a pas de frais de fusion ou d'API OCR car ces outils ne sont pas des points de terminaison d'API. Les tarifs en direct sont sur le Forfaits et tarifs page.

Pourquoi E-Signer n'est pas une voie

La signature est un double flux de travail du navigateur : l'expéditeur place des champs sur la page et le destinataire ouvre un lien et signe. Un client HTTP ne peut pas voir la mise en page ni exploiter cette page, donc une « API de signature électronique » s'arrêterait avant la fin du travail. Les enveloppes se trouvent dans le tableau de bord E-Signer ; l'API ne les crée ni ne les signe.

Clés et conservation des fichiers

Traitez une clé API comme un mot de passe : une clé par application, faites-la pivoter si elle a été collée dans un référentiel public et ne la mettez jamais dans le JavaScript côté navigateur. Les fichiers téléchargés sont des copies de travail temporaires avec un identifiant indevinable ; ce n'est pas un magasin de documents. Conservez les originaux dans votre propre stockage et traitez la réponse API comme la copie dérivée. Le Page de sécurité répertorie les contrôles et la fenêtre de rétention.

Que mesurer avant la mise à niveau

Suivez trois numéros pendant un mois : les appels réussis, les appels échoués et le solde créditeur à la fin. Rédiger et Comparer sont payants (5 crédits chacun), donc un mois chargé est visible dans le solde ; les appels sur le compte coûtent 1. Si les nouvelles tentatives ou les pics du mois de pointe consomment des crédits, un forfait plus important est moins cher qu'un lot échoué. Étant donné que les crédits inutilisés sont reportés, un mois tranquille n’est pas perdu.

E-Signer fonctionne uniquement sur navigateur. Quelqu'un doit placer visuellement les champs de signature du destinataire, et le destinataire doit ouvrir une page de signature et la signer. Un client HTTP ne peut faire ni l’un ni l’autre, il n’existe donc aucune route API pour créer, signer, répertorier ou interroger les enveloppes. Le tableau de bord E-Signer reste le bon endroit pour ce travail.

Le même test supprime pour l'instant la fusion, la compression, la conversion et l'éditeur de l'API : leur flux de travail utile est interactif et lourd en fichiers. Ils restent gratuits dans le navigateur plutôt que d’être annoncés comme des points de terminaison à moitié fonctionnels.

Qu'est-ce qu'un crédit achète

Les crédits sont le solde prépayé attaché à un compte commercial. Aujourd'hui, les seules routes API payantes sont GET /v1/me à 1 crédit et Rédiger et Comparer à 5 crédits chacun. Les forfaits incluent toujours une allocation de crédit mensuelle et les crédits inutilisés sont reportés au lieu d'expirer. Nous répertorions les tarifs API en direct sur le Forfaits et tarifs et ne publiez pas les prix par outil pour les itinéraires qui n'existent pas.

Clés, limites et sécurité

Les clés API sont affichées une fois et stockées uniquement sous forme de hachage. Une clé révoquée cesse de fonctionner immédiatement. Réponse aux limites de débit par clé et par IP 429 avec Retry-After, les téléchargements sont limités en fonction de la taille et du nombre de pages, et un compte banni ou sans droit ne peut pas utiliser de clé active. Le Page API documente les trois itinéraires et leurs champs de requête.

Commencer

Créez un compte, activez un forfait Commercial si vous avez besoin de clés API, puis créez la clé dans Mon Compte et appelez GET /v1/me d'abord. Si un outil de navigation peut faire le travail, utilisez l’outil de navigation – il reste gratuit.