Concepts#

Quatre choses restent vraies quel que soit l'endpoint EnConvert que vous appelez : comment vous atteignez l'API, si un appel répond en ligne ou vous remet une tâche à interroger, comment le fichier de sortie vous parvient, et à quelle moitié de l'API votre travail appartient. Ces quatre pages les traitent une bonne fois pour toutes, pour que la référence des endpoints puisse rester centrée sur les endpoints.

Les quatre pages#

• REST, MCP et CLI : il n'existe qu'une seule API HTTP, et le serveur MCP, la CLI, le nœud n8n et les dix SDK en sont tous des clients, authentifiés par la même clé sk_....
• Tâches synchrones et asynchrones : certains appels retournent le résultat fini dans le corps de la réponse, d'autres retournent un identifiant que vous interrogez jusqu'à ce qu'il atteigne un statut terminal. Cette page indique quels endpoints font quoi.
• URLs signées : les fichiers de sortie reviennent sous forme de liens de téléchargement signés à durée limitée plutôt qu'en octets en ligne ; cette page couvre la fenêtre d'expiration, ce qui se passe une fois celle-ci écoulée, et comment récupérer les octets directement à la place.
• V1 et V2 : la V1 convertit des fichiers et des URLs d'un format à l'autre, la V2 lit des pages web en direct pour en faire des données prêtes pour les agents. Même clé, même quota mensuel, forme de requête différente.

Vous ne savez pas par où commencer#

Si vous n'avez pas encore fait de requête, lisez d'abord le guide de démarrage rapide : il vous donne un appel qui fonctionne en trois étapes. L'authentification couvre les deux types de clés et les cas où chacun s'applique. Dès que vous avez besoin du détail au niveau des paramètres, Points de terminaison est la référence, et Guides contient les tutoriels par tâche pour les envois de fichiers, les webhooks et les lots.