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: "Створення стовпчастих, лінійних або кругових діаграм з даних CSV чи JSON."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 92922dd47e97
|
||||
---
|
||||
|
||||
# Chart Maker {#chart-maker}
|
||||
|
||||
Створення стовпчастих, лінійних або кругових діаграм з даних CSV чи JSON. Повертає зображення PNG відрендереної діаграми.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Приймає дані форми multipart з файлом CSV чи JSON та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | No | `"bar"` | Тип діаграми: `bar`, `line`, `pie` |
|
||||
| title | string | No | - | Заголовок діаграми (максимум 120 символів) |
|
||||
| width | integer | No | `960` | Ширина діаграми в пікселях (320-2048) |
|
||||
| height | integer | No | `540` | Висота діаграми в пікселях (240-1536) |
|
||||
|
||||
## Example Request {#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}'
|
||||
```
|
||||
|
||||
## Example Response {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Вхідними даними має бути файл `.csv` або `.json`. Файли CSV повинні мати рядок заголовків з іменами стовпців.
|
||||
- Перший стовпець використовується як мітка категорії; другий стовпець має бути числовим і надає значення даних. Використовуються лише два стовпці.
|
||||
- Вхідні дані JSON мають бути масивом об'єктів `{label, value}` або простим об'єктом, ключі якого стають мітками, а значення - точками даних.
|
||||
- Максимум 100 точок даних. Усі значення мають бути нуль або більше.
|
||||
- Вивід завжди є зображенням PNG незалежно від вхідного формату.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Конвертація між форматами Word, OpenDocument, RTF та простим текстом."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0a1e6888ab88
|
||||
---
|
||||
|
||||
# Convert Document {#convert-document}
|
||||
|
||||
Конвертація документів між форматами Word (DOCX), OpenDocument (ODT), RTF та простим текстом за допомогою LibreOffice.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Приймає дані форми multipart з файлом Word/ODT/RTF/TXT та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Формат виводу: `docx`, `odt`, `rtf`, `txt` |
|
||||
|
||||
## Example Request {#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"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Конвертація обробляється LibreOffice, що працює в безголовому режимі на сервері.
|
||||
- Складне форматування (макроси, вбудовані об'єкти) може не зберегтися під час конвертації між форматами.
|
||||
- Формат виводу має відрізнятися від вхідного формату.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Конвертація між форматами презентацій PowerPoint та OpenDocument."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: bcacb2d65bb7
|
||||
---
|
||||
|
||||
# Convert Presentation {#convert-presentation}
|
||||
|
||||
Конвертація презентацій між форматами PowerPoint (PPTX) та OpenDocument Presentation (ODP).
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Приймає дані форми multipart з файлом PowerPoint/ODP та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Формат виводу: `pptx`, `odp` |
|
||||
|
||||
## Example Request {#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"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.pptx`, `.ppt`, `.odp`.
|
||||
- Конвертація обробляється LibreOffice, що працює в безголовому режимі на сервері.
|
||||
- Анімації та ефекти переходів можуть не зберегтися між форматами.
|
||||
- Формат виводу має відрізнятися від вхідного формату.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Конвертація між форматами Excel, OpenDocument та CSV."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 586f6b3bc56f
|
||||
---
|
||||
|
||||
# Convert Spreadsheet {#convert-spreadsheet}
|
||||
|
||||
Конвертація електронних таблиць між форматами Excel (XLSX), OpenDocument Spreadsheet (ODS) та CSV. Багатоаркушеві книги експортують перший аркуш під час конвертації в CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Приймає дані форми multipart з файлом Excel/ODS/CSV та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Формат виводу: `xlsx`, `ods`, `csv` |
|
||||
|
||||
## Example Request {#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"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Під час конвертації багатоаркушевої книги в CSV експортується лише перший аркуш.
|
||||
- Формули обчислюються та експортуються як статичні значення у виводі CSV.
|
||||
- Формат виводу має відрізнятися від вхідного формату.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Об'єднання кількох файлів в один архів ZIP."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6715ae69a4ae
|
||||
---
|
||||
|
||||
# Create ZIP {#create-zip}
|
||||
|
||||
Об'єднання кількох файлів будь-якого типу в один архів ZIP. Дублікати імен файлів автоматично усуваються.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Приймає дані форми multipart із двома або більше файлами. Поле налаштувань не потрібне.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте від 2 до 50 файлів будь-якого типу для об'єднання.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive.zip",
|
||||
"originalSize": 3500000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Потребує від 2 до 50 вхідних файлів.
|
||||
- Приймається будь-який тип файлу; немає обмежень щодо вхідного формату.
|
||||
- Якщо кілька файлів мають однакове ім'я, вони автоматично усуваються дублюванням із числовими суфіксами.
|
||||
- Вихідний архів використовує стандартне стиснення ZIP (deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Конвертація між CSV та Excel (XLSX) в обох напрямках."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ea756ad786ed
|
||||
---
|
||||
|
||||
# CSV to Excel {#csv-to-excel}
|
||||
|
||||
Конвертація між форматами CSV та Excel (XLSX) в обох напрямках. Завантажте файл CSV чи TSV, щоб отримати XLSX, або завантажте файл XLSX, щоб отримати CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Приймає дані форми multipart з файлом CSV, TSV чи XLSX та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | No | `1` | Номер аркуша для експорту під час конвертації з XLSX (мінімум 1) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV у 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 у 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}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data.xlsx",
|
||||
"originalSize": 2048,
|
||||
"processedSize": 5120
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Напрямок конвертації визначається автоматично з розширення вхідного файлу: `.csv` або `.tsv` дає `.xlsx`, а `.xlsx` дає `.csv`.
|
||||
- Параметр `sheet` застосовується лише під час конвертації з XLSX. Він вибирає, який аркуш експортувати.
|
||||
- Файли TSV (значення, розділені табуляцією) підтримуються поряд із CSV.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Конвертація між CSV та JSON в обох напрямках."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 46a595a41439
|
||||
---
|
||||
|
||||
# CSV to JSON {#csv-to-json}
|
||||
|
||||
Конвертація між форматами CSV та JSON в обох напрямках. Завантажте файл CSV чи TSV, щоб отримати масив об'єктів JSON, або завантажте масив JSON, щоб отримати файл CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Приймає дані форми multipart з файлом CSV, TSV чи JSON та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | No | `true` | Форматований вивід JSON з відступами |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV у 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 у 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={}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
|
||||
"originalSize": 1500,
|
||||
"processedSize": 2200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Напрямок конвертації визначається автоматично з розширення вхідного файлу: `.csv` або `.tsv` дає `.json`, а `.json` дає `.csv`.
|
||||
- Параметр `pretty` впливає лише на вивід JSON. Коли встановлено `false`, вивід є компактним однорядковим рядком JSON.
|
||||
- Вхідні дані JSON мають бути масивом об'єктів із узгодженими ключами. Кожен об'єкт стає рядком, а кожен ключ стає заголовком стовпця.
|
||||
- Файли TSV (значення, розділені табуляцією) підтримуються поряд із CSV.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Конвертація EPUB у PDF, DOCX, HTML або Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 57e827c75f4a
|
||||
---
|
||||
|
||||
# Convert EPUB {#convert-epub}
|
||||
|
||||
Конвертація електронної книги EPUB у PDF, Word (DOCX), HTML або Markdown. Віддалені ресурси всередині книги не завантажуються.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Приймає дані форми multipart з файлом EPUB та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Формат виводу: `pdf`, `docx`, `html`, `md` |
|
||||
|
||||
## Example Request {#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"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятний вхідний формат: `.epub`.
|
||||
- Віддалені ресурси, вбудовані в EPUB (зовнішні зображення, шрифти), не завантажуються з міркувань безпеки.
|
||||
- Точність зображень у конвертованому виводі може відрізнятися залежно від структури EPUB.
|
||||
- Конвертація обробляється Pandoc на сервері.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Конвертація електронних таблиць у PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2f78a13254fa
|
||||
---
|
||||
|
||||
# Excel to PDF {#excel-to-pdf}
|
||||
|
||||
Конвертація електронних таблиць Excel, OpenDocument або CSV у PDF. Широкі аркуші можуть розбиватися на кілька сторінок.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Приймає дані форми multipart з файлом Excel/ODS/CSV.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте електронну таблицю, і її буде конвертовано в PDF.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Широкі аркуші можуть розбиватися на кілька сторінок у результуючому PDF.
|
||||
- Діаграми та умовне форматування рендеряться у виводі PDF.
|
||||
- Конвертація обробляється LibreOffice, що працює в безголовому режимі на сервері.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Безпечне вилучення файлів з архіву ZIP із захистом від бомб."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f4282fb1e671
|
||||
---
|
||||
|
||||
# Extract ZIP {#extract-zip}
|
||||
|
||||
Безпечне вилучення файлів з архіву ZIP. Архіви з одним файлом повертають вміщений файл безпосередньо; архіви з кількома файлами повертають плаский ZIP із вилученим вмістом.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Приймає дані форми multipart з файлом ZIP. Поле налаштувань не потрібне.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте файл `.zip` для вилучення.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Як вхідні дані приймаються лише файли `.zip`.
|
||||
- Якщо архів містить один файл, цей файл повертається безпосередньо (не загорнутий у ZIP).
|
||||
- Якщо архів містить кілька файлів, повертається плаский ZIP з усіма файлами, вилученими на кореневий рівень (вкладена структура каталогів вирівнюється).
|
||||
- Вбудований захист від бомб відхиляє архіви з надмірними коефіцієнтами стиснення або кількістю файлів, щоб запобігти вичерпанню ресурсів.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Конвертація файлу HTML у PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 592f9cad99c5
|
||||
---
|
||||
|
||||
# HTML to PDF {#html-to-pdf}
|
||||
|
||||
Конвертація файлу HTML у стилізований документ PDF. Віддалені ресурси (зовнішні зображення, таблиці стилів, скрипти) вимкнено для приватності.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Приймає дані форми multipart з файлом HTML.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте файл HTML, і його буде конвертовано в PDF.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте прогрес через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.html`, `.htm`.
|
||||
- Віддалені ресурси (зображення, таблиці стилів, скрипти, на які посилаються через URL) не завантажуються з міркувань приватності та безпеки.
|
||||
- Вбудовані стилі та вбудовані зображення (data URI) зберігаються.
|
||||
- Конвертація обробляється WeasyPrint на сервері.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Конвертація між JSON та XML в обох напрямках."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4e39b9675ce7
|
||||
---
|
||||
|
||||
# JSON to XML {#json-to-xml}
|
||||
|
||||
Конвертація між форматами JSON та XML в обох напрямках. Завантажте файл JSON, щоб отримати XML, або завантажте файл XML, щоб отримати JSON.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Приймає дані форми multipart з файлом JSON чи XML та JSON-полем `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | No | `true` | Форматований вивід з відступами |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
JSON у 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 у 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}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
|
||||
"originalSize": 850,
|
||||
"processedSize": 1200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Напрямок конвертації визначається автоматично з розширення вхідного файлу: `.json` дає `.xml`, а `.xml` дає `.json`.
|
||||
- Параметр `pretty` застосовується в обох напрямках. Коли `false`, вивід є компактним без відступів.
|
||||
- Атрибути XML та вкладені структури зберігаються під час зворотної конвертації, де це можливо.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Конвертація файлу Markdown у документ Word (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 887152388e77
|
||||
---
|
||||
|
||||
# Markdown to Word {#markdown-to-word}
|
||||
|
||||
Конвертація файлу Markdown у документ Word (DOCX) зі збереженням заголовків, списків, блоків коду та іншого форматування.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Приймає дані форми multipart з файлом Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте файл Markdown, і його буде конвертовано в DOCX.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/README.docx",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 18200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.md`, `.markdown`.
|
||||
- Це швидкий (синхронний) інструмент, який повертає результат безпосередньо.
|
||||
- Заголовки, жирний текст, курсив, посилання, блоки коду та списки зіставляються зі стилями Word.
|
||||
- Конвертація обробляється Pandoc на сервері.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Конвертація файлу Markdown у самодостатню сторінку HTML."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d9177db5a861
|
||||
---
|
||||
|
||||
# Markdown to HTML {#markdown-to-html}
|
||||
|
||||
Конвертація файлу Markdown у самодостатню сторінку HTML. Віддалені зображення, на які посилається джерело, залишаються без змін у виводі.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Приймає дані форми multipart з файлом Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Цей інструмент не має налаштовуваних параметрів. Завантажте файл Markdown, і його буде конвертовано в HTML.
|
||||
|
||||
## Example Request {#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"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/notes.html",
|
||||
"originalSize": 3200,
|
||||
"processedSize": 5800
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.md`, `.markdown`.
|
||||
- Це швидкий (синхронний) інструмент, який повертає результат безпосередньо.
|
||||
- Вивід є самодостатньою сторінкою HTML із вбудованими стилями.
|
||||
- Віддалені URL-адреси зображень у джерелі Markdown зберігаються без змін і не завантажуються.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Перетворення файлу Markdown на стилізований PDF."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 73440d39b9ad
|
||||
---
|
||||
|
||||
# Markdown у PDF {#markdown-to-pdf}
|
||||
|
||||
Перетворення файлу Markdown на стилізований документ PDF. З міркувань конфіденційності віддалені ресурси вимкнено.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом Markdown.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Завантажте файл Markdown, і його буде перетворено на PDF.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте перебіг через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.md`, `.markdown`.
|
||||
- З міркувань конфіденційності та безпеки віддалені ресурси (зображення, таблиці стилів, на які посилаються через URL) не завантажуються.
|
||||
- Спочатку Markdown відображається у HTML, а потім перетворюється на PDF за допомогою WeasyPrint.
|
||||
- Блоки коду, таблиці та інші елементи Markdown стилізуються у вихідному PDF.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Об'єднання кількох файлів CSV або TSV із однаковими стовпцями в один."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 03130bd42ef3
|
||||
---
|
||||
|
||||
# Об'єднання CSV {#merge-csvs}
|
||||
|
||||
Об'єднання кількох файлів CSV або TSV із однаковими стовпцями в один зведений файл. Усі вхідні файли повинні мати однакові заголовки стовпців.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Приймає дані форми у форматі multipart із двома або більше файлами CSV. Поле налаштувань не потрібне.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Завантажте від 2 до 20 файлів CSV або TSV з однаковими заголовками стовпців.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Потрібно від 2 до 20 вхідних файлів.
|
||||
- Усі файли повинні мати однакові заголовки стовпців. Якщо стовпці не збігаються, об'єднання завершиться помилкою.
|
||||
- Рядок заголовка включається у вихідний файл один раз; рядки даних з усіх файлів об'єднуються в порядку завантаження.
|
||||
- Приймаються як файли CSV, так і TSV, але всі файли в одному запиті повинні використовувати однаковий роздільник.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Перетворення презентацій на PDF."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 404acb2d24f5
|
||||
---
|
||||
|
||||
# PowerPoint у PDF {#powerpoint-to-pdf}
|
||||
|
||||
Перетворення презентацій PowerPoint або OpenDocument на PDF, по одному слайду на сторінку.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом PowerPoint/ODP.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Завантажте презентацію, і її буде перетворено на PDF.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте перебіг через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.pptx`, `.ppt`, `.odp`.
|
||||
- Кожен слайд стає однією сторінкою у PDF.
|
||||
- Перетворення виконується LibreOffice, що працює у безголовому режимі на сервері.
|
||||
- Анімації та переходи не включаються у вихідний PDF.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Розділення CSV на менші файли за кількістю рядків."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 833bd35c2eca
|
||||
---
|
||||
|
||||
# Розділення CSV {#split-csv}
|
||||
|
||||
Розділення великого файлу CSV або TSV на менші файли за кількістю рядків. Повертає архів ZIP із частинами.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом CSV та полем JSON `settings`.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | integer | Ні | `1000` | Кількість рядків даних на вихідний файл (1-1 000 000) |
|
||||
| keepHeader | boolean | Ні | `true` | Повторювати рядок заголовка в кожному вихідному файлі |
|
||||
|
||||
## Приклад запиту {#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}'
|
||||
```
|
||||
|
||||
## Приклад відповіді {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Вихідні дані завжди є архівом ZIP, що містить розділені частини CSV, названі послідовно (наприклад, `part-1.csv`, `part-2.csv`).
|
||||
- Коли `keepHeader` має значення `true`, кожна частина включає початковий рядок заголовка, тому кожен файл можна використовувати незалежно.
|
||||
- Як вхідні дані приймаються файли CSV та TSV.
|
||||
- Кількість рядків стосується лише рядків даних; рядок заголовка не враховується.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Перетворення файлів Word, Markdown, HTML або звичайного тексту на EPUB."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e7250f334117
|
||||
---
|
||||
|
||||
# Перетворення на EPUB {#convert-to-epub}
|
||||
|
||||
Перетворення документів Word, Markdown, HTML або файлів звичайного тексту на формат електронних книг EPUB.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом Word/Markdown/HTML/TXT.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Завантажте документ, і його буде перетворено на EPUB.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте перебіг через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.docx`, `.md`, `.html`, `.txt`.
|
||||
- Вихідні дані EPUB відповідають специфікації EPUB 3.
|
||||
- Заголовки у вихідному документі використовуються для створення змісту.
|
||||
- Перетворення виконується Pandoc на сервері.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Перетворення документів Word на PDF."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 82292e19b738
|
||||
---
|
||||
|
||||
# Word у PDF {#word-to-pdf}
|
||||
|
||||
Перетворення документів Word, тексту OpenDocument, RTF або файлів звичайного тексту на PDF.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом Word/ODT/RTF/TXT.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Завантажте документ, і його буде перетворено на PDF.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
Повертає `202 Accepted`. Відстежуйте перебіг через SSE за адресою `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Прийнятні вхідні формати: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Перетворення виконується LibreOffice, що працює у безголовому режимі на сервері.
|
||||
- За наявності використовуються шрифти, вбудовані в документ; інакше підставляються системні шрифти.
|
||||
- Колонтитули, таблиці та зображення зберігаються у вихідному PDF.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Витягнення повторюваних елементів з XML у таблицю CSV."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: cbafbd9a9199
|
||||
---
|
||||
|
||||
# XML у CSV {#xml-to-csv}
|
||||
|
||||
Витягнення повторюваних елементів з файлу XML у пласку таблицю CSV. Інструмент автоматично знаходить перший масив об'єктів у дереві XML і зіставляє кожен елемент з рядком.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом XML. Поле налаштувань не потрібне.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Повторюваний елемент визначається автоматично зі структури XML.
|
||||
|
||||
## Приклад запиту {#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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Як вхідні дані приймаються лише файли `.xml`.
|
||||
- Інструмент сканує дерево XML на перший повторюваний набір сусідніх елементів і використовує їх як рядки.
|
||||
- Кожне унікальне ім'я дочірнього елемента або атрибута стає заголовком стовпця CSV.
|
||||
- Це одностороннє перетворення. Для двостороннього перетворення JSON/XML використовуйте інструмент [JSON у XML](/uk/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "Перетворення між YAML та JSON в обох напрямках."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9485ff5bde52
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Перетворення між форматами YAML та JSON в обох напрямках. Завантажте файл YAML, щоб отримати JSON, або файл JSON, щоб отримати YAML.
|
||||
|
||||
## Кінцева точка API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Приймає дані форми у форматі multipart із файлом YAML або JSON. Поле налаштувань не потрібне.
|
||||
|
||||
## Параметри {#parameters}
|
||||
|
||||
Цей інструмент не має настроюваних параметрів. Напрямок перетворення визначається за розширенням вхідного файлу.
|
||||
|
||||
## Приклад запиту {#example-request}
|
||||
|
||||
YAML у 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 у 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"
|
||||
```
|
||||
|
||||
## Приклад відповіді {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Примітки {#notes}
|
||||
|
||||
- Напрямок перетворення визначається автоматично за розширенням вхідного файлу: `.yaml` або `.yml` дає `.json`, а `.json` дає `.yaml`.
|
||||
- Приймаються обидва розширення `.yaml` та `.yml`.
|
||||
- Перетворюється лише перший документ у багатодокументному файлі YAML; додаткові документи, розділені `---`, ігноруються.
|
||||
Reference in New Issue
Block a user