mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
This commit is contained in:
SnapOtter
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Crée des graphiques en barres, en courbes ou en camembert à partir de données CSV ou JSON."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2f40ee78e330
|
||||
---
|
||||
|
||||
# Créateur de graphiques {#chart-maker}
|
||||
|
||||
Crée des graphiques en barres, en courbes ou en camembert à partir de données CSV ou JSON. Renvoie une image PNG du graphique rendu.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier CSV ou JSON et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | Non | `"bar"` | Type de graphique : `bar`, `line`, `pie` |
|
||||
| title | string | Non | - | Titre du graphique (120 caractères max.) |
|
||||
| width | integer | Non | `960` | Largeur du graphique en pixels (320-2048) |
|
||||
| height | integer | Non | `540` | Hauteur du graphique en pixels (240-1536) |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/chart-maker \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@sales.csv" \
|
||||
-F 'settings={"kind": "line", "title": "Monthly Sales", "width": 960, "height": 540}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sales_chart.png",
|
||||
"originalSize": 1024,
|
||||
"processedSize": 48500
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- L'entrée doit être un fichier `.csv` ou `.json`. Les fichiers CSV doivent comporter une ligne d'en-tête avec les noms des colonnes.
|
||||
- La première colonne sert d'étiquette de catégorie ; la deuxième colonne doit être numérique et fournit les valeurs des données. Seules deux colonnes sont utilisées.
|
||||
- L'entrée JSON doit être un tableau d'objets `{label, value}`, ou un objet simple dont les clés deviennent des étiquettes et les valeurs des points de données.
|
||||
- Maximum de 100 points de données. Toutes les valeurs doivent être supérieures ou égales à zéro.
|
||||
- La sortie est toujours une image PNG, quel que soit le format d'entrée.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertit entre les formats Word, OpenDocument, RTF et texte brut."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 37d5884d6c87
|
||||
---
|
||||
|
||||
# Convertir un document {#convert-document}
|
||||
|
||||
Convertit des documents entre les formats Word (DOCX), OpenDocument (ODT), RTF et texte brut à l'aide de LibreOffice.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier Word/ODT/RTF/TXT et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Oui | - | Format de sortie : `docx`, `odt`, `rtf`, `txt` |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-document \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.docx" \
|
||||
-F 'settings={"format": "odt"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- La conversion est effectuée par LibreOffice exécuté en mode headless sur le serveur.
|
||||
- La mise en forme complexe (macros, objets intégrés) peut ne pas survivre à la conversion entre formats.
|
||||
- Le format de sortie doit être différent du format d'entrée.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertit entre les formats de présentation PowerPoint et OpenDocument."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e41400cd701d
|
||||
---
|
||||
|
||||
# Convertir une présentation {#convert-presentation}
|
||||
|
||||
Convertit des présentations entre les formats PowerPoint (PPTX) et OpenDocument Presentation (ODP).
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier PowerPoint/ODP et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Oui | - | Format de sortie : `pptx`, `odp` |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-presentation \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@slides.pptx" \
|
||||
-F 'settings={"format": "odp"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.pptx`, `.ppt`, `.odp`.
|
||||
- La conversion est effectuée par LibreOffice exécuté en mode headless sur le serveur.
|
||||
- Les animations et les effets de transition peuvent ne pas être conservés d'un format à l'autre.
|
||||
- Le format de sortie doit être différent du format d'entrée.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertit entre les formats Excel, OpenDocument et CSV."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 19b28617bab8
|
||||
---
|
||||
|
||||
# Convertir une feuille de calcul {#convert-spreadsheet}
|
||||
|
||||
Convertit des feuilles de calcul entre les formats Excel (XLSX), OpenDocument Spreadsheet (ODS) et CSV. Les classeurs à plusieurs feuilles exportent la première feuille lors de la conversion en CSV.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier Excel/ODS/CSV et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Oui | - | Format de sortie : `xlsx`, `ods`, `csv` |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-spreadsheet \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@data.xlsx" \
|
||||
-F 'settings={"format": "csv"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Lors de la conversion d'un classeur à plusieurs feuilles en CSV, seule la première feuille est exportée.
|
||||
- Les formules sont évaluées et exportées sous forme de valeurs statiques dans la sortie CSV.
|
||||
- Le format de sortie doit être différent du format d'entrée.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Regroupe plusieurs fichiers dans une seule archive ZIP."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: eb644dc4819e
|
||||
---
|
||||
|
||||
# Créer un ZIP {#create-zip}
|
||||
|
||||
Regroupe plusieurs fichiers de tout type dans une seule archive ZIP. Les noms de fichiers en double sont automatiquement dédupliqués.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Accepte des données de formulaire multipart avec deux fichiers ou plus. Aucun champ de réglages n'est requis.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez entre 2 et 50 fichiers de tout type à regrouper.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/create-zip \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.pdf" \
|
||||
-F "file=@data.csv" \
|
||||
-F "file=@photo.jpg"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive.zip",
|
||||
"originalSize": 3500000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Nécessite entre 2 et 50 fichiers d'entrée.
|
||||
- Tout type de fichier est accepté ; il n'y a aucune restriction sur le format d'entrée.
|
||||
- Si plusieurs fichiers portent le même nom, ils sont automatiquement dédupliqués avec des suffixes numériques.
|
||||
- L'archive de sortie utilise la compression ZIP standard (deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Convertit entre CSV et Excel (XLSX), dans les deux sens."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 34ca3514ed7d
|
||||
---
|
||||
|
||||
# CSV vers Excel {#csv-to-excel}
|
||||
|
||||
Convertit entre les formats CSV et Excel (XLSX) dans les deux sens. Chargez un fichier CSV ou TSV pour obtenir un XLSX, ou chargez un fichier XLSX pour obtenir un CSV.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier CSV, TSV ou XLSX et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | Non | `1` | Numéro de la feuille de calcul à exporter lors de la conversion depuis XLSX (min. 1) |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
CSV vers Excel :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-excel \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@data.csv" \
|
||||
-F 'settings={"sheet": 1}'
|
||||
```
|
||||
|
||||
Excel vers CSV :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-excel \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.xlsx" \
|
||||
-F 'settings={"sheet": 2}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data.xlsx",
|
||||
"originalSize": 2048,
|
||||
"processedSize": 5120
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Le sens de conversion est détecté automatiquement à partir de l'extension du fichier d'entrée : `.csv` ou `.tsv` produit `.xlsx`, et `.xlsx` produit `.csv`.
|
||||
- Le paramètre `sheet` ne s'applique que lors de la conversion depuis XLSX. Il sélectionne la feuille de calcul à exporter.
|
||||
- Les fichiers TSV (valeurs séparées par des tabulations) sont pris en charge au même titre que le CSV.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Convertit entre CSV et JSON, dans les deux sens."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 64b6acf9d805
|
||||
---
|
||||
|
||||
# CSV vers JSON {#csv-to-json}
|
||||
|
||||
Convertit entre les formats CSV et JSON dans les deux sens. Chargez un fichier CSV ou TSV pour obtenir un tableau JSON d'objets, ou chargez un tableau JSON pour obtenir un fichier CSV.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier CSV, TSV ou JSON et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Non | `true` | Met en forme la sortie JSON avec indentation |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
CSV vers JSON :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@users.csv" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
JSON vers CSV :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@users.json" \
|
||||
-F 'settings={}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
|
||||
"originalSize": 1500,
|
||||
"processedSize": 2200
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Le sens de conversion est détecté automatiquement à partir de l'extension du fichier d'entrée : `.csv` ou `.tsv` produit `.json`, et `.json` produit `.csv`.
|
||||
- Le paramètre `pretty` n'affecte que la sortie JSON. Lorsqu'il est défini sur `false`, la sortie est une chaîne JSON compacte sur une seule ligne.
|
||||
- L'entrée JSON doit être un tableau d'objets avec des clés cohérentes. Chaque objet devient une ligne, et chaque clé devient un en-tête de colonne.
|
||||
- Les fichiers TSV (valeurs séparées par des tabulations) sont pris en charge au même titre que le CSV.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertit un EPUB en PDF, DOCX, HTML ou Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c403470bb3d
|
||||
---
|
||||
|
||||
# Convertir un EPUB {#convert-epub}
|
||||
|
||||
Convertit un livre électronique EPUB en PDF, Word (DOCX), HTML ou Markdown. Les ressources distantes contenues dans le livre ne sont pas récupérées.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier EPUB et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Oui | - | Format de sortie : `pdf`, `docx`, `html`, `md` |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/epub-convert \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@book.epub" \
|
||||
-F 'settings={"format": "pdf"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Format d'entrée accepté : `.epub`.
|
||||
- Les ressources distantes intégrées dans l'EPUB (images externes, polices) ne sont pas récupérées pour des raisons de sécurité.
|
||||
- La fidélité des images dans la sortie convertie peut varier selon la structure de l'EPUB.
|
||||
- La conversion est effectuée par Pandoc sur le serveur.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit des feuilles de calcul en PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 91307fe17421
|
||||
---
|
||||
|
||||
# Excel vers PDF {#excel-to-pdf}
|
||||
|
||||
Convertit des feuilles de calcul Excel, OpenDocument ou CSV en PDF. Les feuilles larges peuvent être paginées sur plusieurs pages.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier Excel/ODS/CSV.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez une feuille de calcul et elle sera convertie en PDF.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/excel-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@budget.xlsx"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Les feuilles larges peuvent être réparties sur plusieurs pages dans le PDF résultant.
|
||||
- Les graphiques et la mise en forme conditionnelle sont rendus dans la sortie PDF.
|
||||
- La conversion est effectuée par LibreOffice exécuté en mode headless sur le serveur.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Extrait en toute sécurité les fichiers d'une archive ZIP avec protection contre les bombes."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c16425228cdd
|
||||
---
|
||||
|
||||
# Extraire un ZIP {#extract-zip}
|
||||
|
||||
Extrait en toute sécurité les fichiers d'une archive ZIP. Les archives à fichier unique renvoient directement le fichier contenu ; les archives à plusieurs fichiers renvoient un ZIP à plat avec le contenu extrait.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier ZIP. Aucun champ de réglages n'est requis.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez un fichier `.zip` à extraire.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/extract-zip \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@archive.zip"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive_extracted.zip",
|
||||
"originalSize": 2800000,
|
||||
"processedSize": 3500000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Seuls les fichiers `.zip` sont acceptés en entrée.
|
||||
- Si l'archive contient un seul fichier, ce fichier est renvoyé directement (et non enveloppé dans un ZIP).
|
||||
- Si l'archive contient plusieurs fichiers, un ZIP à plat est renvoyé avec tous les fichiers extraits à la racine (la structure de répertoires imbriqués est aplatie).
|
||||
- Une protection intégrée contre les bombes rejette les archives présentant des taux de compression ou des nombres de fichiers excessifs afin d'éviter l'épuisement des ressources.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit un fichier HTML en PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 47fbe044ba88
|
||||
---
|
||||
|
||||
# HTML vers PDF {#html-to-pdf}
|
||||
|
||||
Convertit un fichier HTML en un document PDF mis en forme. Les ressources distantes (images externes, feuilles de style, scripts) sont désactivées pour préserver la confidentialité.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier HTML.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez un fichier HTML et il sera converti en PDF.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/html-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@page.html"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE à `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.html`, `.htm`.
|
||||
- Les ressources distantes (images, feuilles de style, scripts référencés via des URL) ne sont pas récupérées pour des raisons de confidentialité et de sécurité.
|
||||
- Les styles en ligne et les images intégrées (data URI) sont conservés.
|
||||
- La conversion est effectuée par WeasyPrint sur le serveur.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Convertit entre JSON et XML, dans les deux sens."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 557e796d4a1b
|
||||
---
|
||||
|
||||
# JSON vers XML {#json-to-xml}
|
||||
|
||||
Convertit entre les formats JSON et XML dans les deux sens. Chargez un fichier JSON pour obtenir du XML, ou chargez un fichier XML pour obtenir du JSON.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier JSON ou XML et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Non | `true` | Met en forme la sortie avec indentation |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
JSON vers XML :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.json" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
XML vers JSON :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.xml" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
|
||||
"originalSize": 850,
|
||||
"processedSize": 1200
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Le sens de conversion est détecté automatiquement à partir de l'extension du fichier d'entrée : `.json` produit `.xml`, et `.xml` produit `.json`.
|
||||
- Le paramètre `pretty` s'applique dans les deux sens. Lorsqu'il vaut `false`, la sortie est compacte sans indentation.
|
||||
- Les attributs XML et les structures imbriquées sont conservés lors de la conversion aller-retour lorsque cela est possible.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit un fichier Markdown en document Word (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 93afb01d2191
|
||||
---
|
||||
|
||||
# Markdown vers Word {#markdown-to-word}
|
||||
|
||||
Convertit un fichier Markdown en document Word (DOCX), en conservant les titres, les listes, les blocs de code et les autres éléments de mise en forme.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier Markdown.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez un fichier Markdown et il sera converti en DOCX.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-docx \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@README.md"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/README.docx",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 18200
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.md`, `.markdown`.
|
||||
- C'est un outil rapide (synchrone) qui renvoie le résultat directement.
|
||||
- Les titres, le gras, l'italique, les liens, les blocs de code et les listes sont mappés vers les styles Word.
|
||||
- La conversion est effectuée par Pandoc sur le serveur.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit un fichier Markdown en une page HTML autonome."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ff851dcc58e0
|
||||
---
|
||||
|
||||
# Markdown vers HTML {#markdown-to-html}
|
||||
|
||||
Convertit un fichier Markdown en une page HTML autonome. Les images distantes référencées dans la source sont laissées telles quelles dans la sortie.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier Markdown.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Chargez un fichier Markdown et il sera converti en HTML.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-html \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@notes.md"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/notes.html",
|
||||
"originalSize": 3200,
|
||||
"processedSize": 5800
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.md`, `.markdown`.
|
||||
- C'est un outil rapide (synchrone) qui renvoie le résultat directement.
|
||||
- La sortie est une page HTML autonome avec des styles en ligne.
|
||||
- Les URL d'images distantes dans la source Markdown sont conservées telles quelles et ne sont pas récupérées.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit un fichier Markdown en PDF mis en forme."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c55755e6870
|
||||
---
|
||||
|
||||
# Markdown vers PDF {#markdown-to-pdf}
|
||||
|
||||
Convertit un fichier Markdown en document PDF mis en forme. Les ressources distantes sont désactivées pour préserver la confidentialité.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier Markdown.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Téléversez un fichier Markdown et il sera converti en PDF.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.md"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE sur `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.md`, `.markdown`.
|
||||
- Les ressources distantes (images, feuilles de style référencées par URL) ne sont pas récupérées, pour des raisons de confidentialité et de sécurité.
|
||||
- Le Markdown est d'abord rendu en HTML, puis converti en PDF via WeasyPrint.
|
||||
- Les blocs de code, les tableaux et les autres éléments Markdown sont mis en forme dans le PDF de sortie.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Combine plusieurs fichiers CSV ou TSV aux colonnes identiques en un seul."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6daf28bf50d5
|
||||
---
|
||||
|
||||
# Fusionner des CSV {#merge-csvs}
|
||||
|
||||
Combine plusieurs fichiers CSV ou TSV aux colonnes identiques en un seul fichier fusionné. Tous les fichiers d'entrée doivent avoir les mêmes en-têtes de colonnes.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Accepte des données de formulaire multipart contenant deux fichiers CSV ou plus. Aucun champ de paramètres n'est requis.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Téléversez 2 à 20 fichiers CSV ou TSV ayant les mêmes en-têtes de colonnes.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/merge-csvs \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@january.csv" \
|
||||
-F "file=@february.csv" \
|
||||
-F "file=@march.csv"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Nécessite entre 2 et 20 fichiers d'entrée.
|
||||
- Tous les fichiers doivent partager les mêmes en-têtes de colonnes. La fusion échoue si les colonnes ne correspondent pas.
|
||||
- La ligne d'en-tête est incluse une seule fois dans la sortie ; les lignes de données de tous les fichiers sont concaténées dans l'ordre de téléversement.
|
||||
- Les fichiers CSV et TSV sont tous deux acceptés, mais tous les fichiers d'une même requête doivent utiliser le même délimiteur.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit des présentations en PDF."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c236ef164143
|
||||
---
|
||||
|
||||
# PowerPoint vers PDF {#powerpoint-to-pdf}
|
||||
|
||||
Convertit des présentations PowerPoint ou OpenDocument en PDF, avec une diapositive par page.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier PowerPoint/ODP.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Téléversez une présentation et elle sera convertie en PDF.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/powerpoint-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@slides.pptx"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE sur `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.pptx`, `.ppt`, `.odp`.
|
||||
- Chaque diapositive devient une page du PDF.
|
||||
- La conversion est prise en charge par LibreOffice exécuté en mode headless sur le serveur.
|
||||
- Les animations et les transitions ne sont pas incluses dans le PDF de sortie.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Découpe un CSV en fichiers plus petits selon le nombre de lignes."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b5942d5159af
|
||||
---
|
||||
|
||||
# Découper un CSV {#split-csv}
|
||||
|
||||
Découpe un gros fichier CSV ou TSV en fichiers plus petits selon le nombre de lignes. Renvoie une archive ZIP contenant les parties.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier CSV et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | entier | Non | `1000` | Nombre de lignes de données par fichier de sortie (1 à 1 000 000) |
|
||||
| keepHeader | booléen | Non | `true` | Répète la ligne d'en-tête dans chaque fichier de sortie |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/split-csv \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@large-dataset.csv" \
|
||||
-F 'settings={"rowsPerFile": 500, "keepHeader": true}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/large-dataset_parts.zip",
|
||||
"originalSize": 1048576,
|
||||
"processedSize": 1050000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- La sortie est toujours une archive ZIP contenant les parties du CSV découpé, nommées séquentiellement (par exemple `part-1.csv`, `part-2.csv`).
|
||||
- Lorsque `keepHeader` vaut `true`, chaque partie inclut la ligne d'en-tête d'origine, de sorte que chaque fichier peut être utilisé indépendamment.
|
||||
- Les fichiers CSV et TSV sont tous deux acceptés en entrée.
|
||||
- Le nombre de lignes fait uniquement référence aux lignes de données ; la ligne d'en-tête n'est pas comptabilisée.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit des fichiers Word, Markdown, HTML ou texte brut en EPUB."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 188bb143bd5c
|
||||
---
|
||||
|
||||
# Convertir en EPUB {#convert-to-epub}
|
||||
|
||||
Convertit des documents Word, du Markdown, du HTML ou des fichiers texte brut au format de livre numérique EPUB.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier Word/Markdown/HTML/TXT.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Téléversez un document et il sera converti en EPUB.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/to-epub \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@manuscript.docx"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE sur `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.docx`, `.md`, `.html`, `.txt`.
|
||||
- La sortie EPUB respecte la spécification EPUB 3.
|
||||
- Les titres du document source servent à générer la table des matières.
|
||||
- La conversion est prise en charge par Pandoc sur le serveur.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Convertit des documents Word en PDF."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 911e578a57de
|
||||
---
|
||||
|
||||
# Word vers PDF {#word-to-pdf}
|
||||
|
||||
Convertit des documents Word, du texte OpenDocument, du RTF ou des fichiers texte brut en PDF.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier Word/ODT/RTF/TXT.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Téléversez un document et il sera converti en PDF.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/word-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.docx"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
Renvoie `202 Accepted`. Suivez la progression via SSE sur `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Formats d'entrée acceptés : `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- La conversion est prise en charge par LibreOffice exécuté en mode headless sur le serveur.
|
||||
- Les polices intégrées au document sont utilisées lorsqu'elles sont disponibles ; sinon, des polices système sont substituées.
|
||||
- Les en-têtes, pieds de page, tableaux et images sont préservés dans le PDF de sortie.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Extrait les éléments répétés d'un XML vers un tableau CSV."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9fe368beb623
|
||||
---
|
||||
|
||||
# XML vers CSV {#xml-to-csv}
|
||||
|
||||
Extrait les éléments répétés d'un fichier XML vers un tableau CSV plat. L'outil trouve automatiquement le premier tableau d'objets dans l'arbre XML et associe chaque élément à une ligne.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier XML. Aucun champ de paramètres n'est requis.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. L'élément répété est détecté automatiquement à partir de la structure XML.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/xml-to-csv \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@catalog.xml"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Seuls les fichiers `.xml` sont acceptés en entrée.
|
||||
- L'outil parcourt l'arbre XML à la recherche du premier ensemble répété d'éléments frères et les utilise comme lignes.
|
||||
- Chaque nom d'élément enfant ou d'attribut unique devient un en-tête de colonne CSV.
|
||||
- Il s'agit d'une conversion à sens unique. Pour une conversion JSON/XML bidirectionnelle, utilisez l'outil [JSON vers XML](/fr/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "Convertit entre YAML et JSON, dans les deux sens."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b8a94654ee90
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Convertit entre les formats YAML et JSON dans les deux sens. Téléversez un fichier YAML pour obtenir du JSON, ou téléversez un fichier JSON pour obtenir du YAML.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Accepte des données de formulaire multipart contenant un fichier YAML ou JSON. Aucun champ de paramètres n'est requis.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Le sens de la conversion est déterminé par l'extension du fichier d'entrée.
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
YAML vers JSON :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.yaml"
|
||||
```
|
||||
|
||||
JSON vers YAML :
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.json"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Le sens de la conversion est détecté automatiquement à partir de l'extension du fichier d'entrée : `.yaml` ou `.yml` produit `.json`, et `.json` produit `.yaml`.
|
||||
- Les extensions `.yaml` et `.yml` sont toutes deux acceptées.
|
||||
- Seul le premier document d'un fichier YAML multi-documents est converti ; les documents supplémentaires séparés par `---` sont ignorés.
|
||||
Reference in New Issue
Block a user