API de conversion de fichiers EnConvert#
EnConvert est une API REST de conversion de fichiers permettant de convertir des documents, des images, des formats de données et des pages web d'un format à l'autre. Par exemple, elle transforme une URL en PDF via /v1/convert/url-to-pdf. Elle donne aux développeurs un accès programmatique à 51 endpoints de conversion ainsi qu'à six endpoints de veille web V2, sans avoir à gérer d'infrastructure de conversion. Les requêtes s'exécutent en mode synchrone ou asynchrone, et le traitement par lots permet de convertir plusieurs fichiers ou URLs en une seule requête.
URL de base :
https://api.enconvert.com
Toutes les requêtes API doivent être adressées à cette URL de base, suivie du chemin d'endpoint approprié (par exemple, https://api.enconvert.com/v1/convert/url-to-pdf).
Fonctionnalités clés#
- 51 endpoints de conversion couvrant les documents, les formats de données, les images et les pages web
- Veille web (V2, bêta) -- percevoir, découvrir, rechercher, extraire, ingérer et surveiller des pages web via six endpoints
/v2, tous appelables aujourd'hui - Deux méthodes d'authentification -- clés privées pour les intégrations serveur à serveur et clés publiques avec JWT pour un usage côté client
- Traitement par lots -- convertissez plusieurs fichiers ou URLs en une seule requête
- Modes synchrone et asynchrone -- obtenez les résultats immédiatement ou interrogez l'état d'avancement des tâches longues
- Notifications de tâches -- recevez des rappels webhook lorsque les conversions asynchrones se terminent
- Widgets web -- intégrez la fonctionnalité de conversion directement dans votre application web
- Aucun SDK requis -- utilisez des requêtes HTTP standard depuis n'importe quel langage ou plateforme
Conversions prises en charge#
Pages web#
| Conversion | Endpoint |
|---|---|
| URL vers PDF | /v1/convert/url-to-pdf |
| URL vers capture d'écran | /v1/convert/url-to-screenshot |
| URL vers Markdown | /v1/convert/url-to-markdown |
| Site web vers PDF | /v1/convert/website-to-pdf |
| Site web vers capture d'écran | /v1/convert/website-to-screenshot |
Formats de données#
| Conversion | Endpoint |
|---|---|
| JSON vers XML | /v1/convert/json-to-xml |
| XML vers JSON | /v1/convert/xml-to-json |
| JSON vers YAML | /v1/convert/json-to-yaml |
| YAML vers JSON | /v1/convert/yaml-to-json |
| JSON vers CSV | /v1/convert/json-to-csv |
| CSV vers JSON | /v1/convert/csv-to-json |
| JSON vers TOML | /v1/convert/json-to-toml |
| TOML vers JSON | /v1/convert/toml-to-json |
| CSV vers XML | /v1/convert/csv-to-xml |
| XML vers CSV | /v1/convert/xml-to-csv |
| Markdown vers HTML | /v1/convert/markdown-to-html |
Documents vers PDF#
| Conversion | Endpoint |
|---|---|
| HTML vers PDF | /v1/convert/html-to-pdf |
| Markdown vers PDF | /v1/convert/markdown-to-pdf |
| Word vers PDF | /v1/convert/doc-to-pdf |
| Excel vers PDF | /v1/convert/excel-to-pdf |
| PowerPoint vers PDF | /v1/convert/ppt-to-pdf |
| Pages vers PDF | /v1/convert/pages-to-pdf |
| Numbers vers PDF | /v1/convert/numbers-to-pdf |
| ODT vers PDF | /v1/convert/odt-to-pdf |
| ODS vers PDF | /v1/convert/ods-to-pdf |
| ODP vers PDF | /v1/convert/odp-to-pdf |
| OTS vers PDF | /v1/convert/ots-to-pdf |
| N'importe quel document en PDF | /v1/convert/anything-to-pdf |
| N'importe quel document en Markdown | /v1/convert/anything-to-markdown |
Conversions d'images#
| Conversion | Endpoint |
|---|---|
| JPEG vers PNG | /v1/convert/jpeg-to-png |
| PNG vers JPEG | /v1/convert/png-to-jpeg |
| JPEG vers SVG | /v1/convert/jpeg-to-svg |
| SVG vers JPEG | /v1/convert/svg-to-jpeg |
| JPEG vers HEIC | /v1/convert/jpeg-to-heic |
| HEIC vers JPEG | /v1/convert/heic-to-jpeg |
| JPEG vers WebP | /v1/convert/jpeg-to-webp |
| WebP vers JPEG | /v1/convert/webp-to-jpeg |
| PNG vers SVG | /v1/convert/png-to-svg |
| SVG vers PNG | /v1/convert/svg-to-png |
| PNG vers HEIC | /v1/convert/png-to-heic |
| HEIC vers PNG | /v1/convert/heic-to-png |
| PNG vers WebP | /v1/convert/png-to-webp |
| WebP vers PNG | /v1/convert/webp-to-png |
| SVG vers HEIC | /v1/convert/svg-to-heic |
| HEIC vers SVG | /v1/convert/heic-to-svg |
| SVG vers WebP | /v1/convert/svg-to-webp |
| WebP vers SVG | /v1/convert/webp-to-svg |
| HEIC vers WebP | /v1/convert/heic-to-webp |
| WebP vers HEIC | /v1/convert/webp-to-heic |
| PDF vers JPEG | /v1/convert/pdf-to-jpeg |
| Compresser une image | /v1/convert/compress-image |
Veille web (V2)#
Les endpoints V2 transforment une URL en quelque chose qu'une application peut exploiter : du Markdown propre, des données structurées, un ensemble de résultats de recherche, des chunks prêts pour le RAG, ou une alerte de changement. Ils s'exécutent sur le même moteur Chrome headless et avec les mêmes clés API que les endpoints de conversion, puisent dans le même quota mensuel unifié d'ops, et ont leur propre statut bêta.
| Endpoint | Ce qu'il fait |
|---|---|
/v2/perceive |
Effectue le rendu d'une URL une seule fois et renvoie du Markdown, du HTML, une capture d'écran, un PDF, des liens et des données structurées à partir de ce rendu unique. |
/v2/discover |
Énumère les URLs d'un site à partir de son sitemap et d'une exploration HTTP, sans effectuer le rendu de chaque page. |
/v2/lookup |
Effectue une recherche web, actualités, universitaire ou cartographique, et perçoit éventuellement les meilleurs résultats. |
/v2/distill |
Extrait des données correspondant à un schéma JSON, avec une passe CSS gratuite et un repli assisté par LLM. |
/v2/ingest |
Explore un site pour produire des chunks prêts pour le RAG et un fichier JSONL, livrés de manière asynchrone. |
/v2/watch |
Surveille une URL pour détecter les changements et vous avertit par webhook ou e-mail lorsqu'elle change. |
Les six sont appelables aujourd'hui avec la même clé. Perceive et Ingest sont en disponibilité générale ; Distill, Lookup, Watch et Discover sont en bêta privée, donc leurs formes de requête et de réponse peuvent changer sans préavis et leurs pages restent sous Bientôt disponible.
Questions fréquentes#
Quels formats de fichiers puis-je convertir avec l'API de conversion de fichiers EnConvert ?#
L'API expose 51 endpoints de conversion répartis en quatre catégories : pages web (URL vers PDF, capture d'écran ou Markdown), formats de données (JSON, XML, YAML, CSV, TOML, Markdown, HTML), documents vers PDF (Word, Excel, PowerPoint, Pages, Numbers et formats OpenDocument), et conversions d'images (JPEG, PNG, SVG, HEIC, WebP).
Ai-je besoin d'un SDK pour utiliser l'API de conversion de fichiers ?#
Non. EnConvert ne nécessite aucun SDK : vous effectuez des requêtes HTTP standard depuis n'importe quel langage ou plateforme vers l'URL de base https://api.enconvert.com, suivie du chemin d'endpoint tel que /v1/convert/url-to-pdf.
L'API prend-elle en charge la conversion de fichiers asynchrone ?#
Oui. L'API propose des modes synchrone et asynchrone : vous obtenez les résultats immédiatement ou vous interrogez l'état d'avancement des tâches longues. Les notifications de tâches délivrent en outre des rappels webhook lorsque les conversions asynchrones se terminent.
Comment m'authentifier auprès de l'API EnConvert ?#
Deux méthodes d'authentification sont prises en charge : les clés privées pour les intégrations serveur à serveur et les clés publiques avec JWT pour un usage côté client.
Où aller ensuite#
- Démarrage rapide lance une première conversion avec cURL, Python ou Node.js.
- Concepts explique les surfaces d'accès, les tâches synchrones et asynchrones, les URLs de sortie signées, et en quoi la V1 et la V2 diffèrent.
- Points de terminaison est la référence pour Perceive, Ingest et toutes les routes de conversion, ainsi que pour les paramètres de requête qu'elles partagent.
- Guides couvre l'ingestion de fichiers, les webhooks, le traitement par lots et les intégrations : MCP, n8n, la CLI et les SDK.