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: 42d55135bce9
|
||||
---
|
||||
|
||||
# 차트 메이커 {#chart-maker}
|
||||
|
||||
CSV 또는 JSON 데이터로 막대, 선, 또는 파이 차트를 만듭니다. 렌더링된 차트의 PNG 이미지를 반환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
CSV 또는 JSON 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | 아니요 | `"bar"` | 차트 유형: `bar`, `line`, `pie` |
|
||||
| title | string | 아니요 | - | 차트 제목(최대 120자) |
|
||||
| width | integer | 아니요 | `960` | 차트 너비(픽셀)(320-2048) |
|
||||
| height | integer | 아니요 | `540` | 차트 높이(픽셀)(240-1536) |
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sales_chart.png",
|
||||
"originalSize": 1024,
|
||||
"processedSize": 48500
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 입력은 `.csv` 또는 `.json` 파일이어야 합니다. CSV 파일에는 열 이름이 있는 헤더 행이 있어야 합니다.
|
||||
- 첫 번째 열은 카테고리 레이블로 사용되며, 두 번째 열은 숫자여야 하고 데이터 값을 제공합니다. 두 개의 열만 사용됩니다.
|
||||
- JSON 입력은 `{label, value}` 객체의 배열이거나, 키가 레이블이 되고 값이 데이터 포인트가 되는 일반 객체여야 합니다.
|
||||
- 최대 100개의 데이터 포인트. 모든 값은 0 이상이어야 합니다.
|
||||
- 입력 형식과 관계없이 출력은 항상 PNG 이미지입니다.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Word, OpenDocument, RTF, 일반 텍스트 형식 간 변환."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 68b853b3c9b2
|
||||
---
|
||||
|
||||
# 문서 변환 {#convert-document}
|
||||
|
||||
LibreOffice를 사용하여 Word(DOCX), OpenDocument(ODT), RTF, 일반 텍스트 형식 간에 문서를 변환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Word/ODT/RTF/TXT 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | 예 | - | 출력 형식: `docx`, `odt`, `rtf`, `txt` |
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- 변환은 서버에서 헤드리스로 실행되는 LibreOffice가 처리합니다.
|
||||
- 복잡한 서식(매크로, 임베디드 객체)은 형식 간 변환 시 유지되지 않을 수 있습니다.
|
||||
- 출력 형식은 입력 형식과 달라야 합니다.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "PowerPoint와 OpenDocument 프레젠테이션 형식 간 변환."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1390a97e9509
|
||||
---
|
||||
|
||||
# 프레젠테이션 변환 {#convert-presentation}
|
||||
|
||||
PowerPoint(PPTX)와 OpenDocument Presentation(ODP) 형식 간에 프레젠테이션을 변환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
PowerPoint/ODP 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | 예 | - | 출력 형식: `pptx`, `odp` |
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.pptx`, `.ppt`, `.odp`.
|
||||
- 변환은 서버에서 헤드리스로 실행되는 LibreOffice가 처리합니다.
|
||||
- 애니메이션 및 전환 효과는 형식 간에 유지되지 않을 수 있습니다.
|
||||
- 출력 형식은 입력 형식과 달라야 합니다.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Excel, OpenDocument, CSV 형식 간 변환."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 76f037815f0c
|
||||
---
|
||||
|
||||
# 스프레드시트 변환 {#convert-spreadsheet}
|
||||
|
||||
Excel(XLSX), OpenDocument Spreadsheet(ODS), CSV 형식 간에 스프레드시트를 변환합니다. 다중 시트 워크북은 CSV로 변환할 때 첫 번째 시트를 내보냅니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Excel/ODS/CSV 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | 예 | - | 출력 형식: `xlsx`, `ods`, `csv` |
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- 다중 시트 워크북을 CSV로 변환할 때는 첫 번째 시트만 내보내집니다.
|
||||
- 수식은 계산되어 CSV 출력에서 정적 값으로 내보내집니다.
|
||||
- 출력 형식은 입력 형식과 달라야 합니다.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "여러 파일을 하나의 ZIP 아카이브로 묶습니다."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f25192b26a01
|
||||
---
|
||||
|
||||
# ZIP 만들기 {#create-zip}
|
||||
|
||||
모든 유형의 여러 파일을 하나의 ZIP 아카이브로 묶습니다. 중복된 파일명은 자동으로 중복 제거됩니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
둘 이상의 파일이 포함된 multipart form data를 받습니다. settings 필드는 필요하지 않습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. 묶을 파일 2-50개를 유형에 관계없이 업로드하세요.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive.zip",
|
||||
"originalSize": 3500000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 2개에서 50개 사이의 입력 파일이 필요합니다.
|
||||
- 모든 파일 유형이 허용되며, 입력 형식에 제한이 없습니다.
|
||||
- 여러 파일이 같은 이름을 공유하는 경우, 숫자 접미사를 붙여 자동으로 중복 제거됩니다.
|
||||
- 출력 아카이브는 표준 ZIP 압축(deflate)을 사용합니다.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "CSV와 Excel(XLSX) 간 양방향 변환."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 45b76d4ed060
|
||||
---
|
||||
|
||||
# CSV to Excel {#csv-to-excel}
|
||||
|
||||
CSV와 Excel(XLSX) 형식 간에 양방향으로 변환합니다. CSV 또는 TSV 파일을 업로드하여 XLSX를 얻거나, XLSX 파일을 업로드하여 CSV를 얻으세요.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
CSV, TSV, 또는 XLSX 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | 아니요 | `1` | XLSX에서 변환할 때 내보낼 워크시트 번호(최소 1) |
|
||||
|
||||
## 요청 예시 {#example-request}
|
||||
|
||||
CSV to 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 to 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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data.xlsx",
|
||||
"originalSize": 2048,
|
||||
"processedSize": 5120
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#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: 25d30511ae25
|
||||
---
|
||||
|
||||
# CSV to JSON {#csv-to-json}
|
||||
|
||||
CSV와 JSON 형식 간에 양방향으로 변환합니다. CSV 또는 TSV 파일을 업로드하여 객체의 JSON 배열을 얻거나, JSON 배열을 업로드하여 CSV 파일을 얻으세요.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
CSV, TSV, 또는 JSON 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | 아니요 | `true` | 들여쓰기와 함께 JSON 출력을 보기 좋게 출력 |
|
||||
|
||||
## 요청 예시 {#example-request}
|
||||
|
||||
CSV to 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 to 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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
|
||||
"originalSize": 1500,
|
||||
"processedSize": 2200
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#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: 19ff29a02151
|
||||
---
|
||||
|
||||
# EPUB 변환 {#convert-epub}
|
||||
|
||||
EPUB 전자책을 PDF, Word(DOCX), HTML, 또는 Markdown으로 변환합니다. 책 내부의 원격 리소스는 가져오지 않습니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
EPUB 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | 예 | - | 출력 형식: `pdf`, `docx`, `html`, `md` |
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.epub`.
|
||||
- EPUB에 임베디드된 원격 리소스(외부 이미지, 폰트)는 보안을 위해 가져오지 않습니다.
|
||||
- 변환된 출력의 이미지 충실도는 EPUB 구조에 따라 달라질 수 있습니다.
|
||||
- 변환은 서버의 Pandoc이 처리합니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "스프레드시트를 PDF로 변환합니다."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b37f293df4d6
|
||||
---
|
||||
|
||||
# Excel to PDF {#excel-to-pdf}
|
||||
|
||||
Excel, OpenDocument, 또는 CSV 스프레드시트를 PDF로 변환합니다. 넓은 시트는 여러 페이지에 걸쳐 분할될 수 있습니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Excel/ODS/CSV 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. 스프레드시트를 업로드하면 PDF로 변환됩니다.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- 넓은 시트는 결과 PDF에서 여러 페이지에 걸쳐 분할될 수 있습니다.
|
||||
- 차트와 조건부 서식은 PDF 출력에 렌더링됩니다.
|
||||
- 변환은 서버에서 헤드리스로 실행되는 LibreOffice가 처리합니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "폭탄 보호 기능으로 ZIP 아카이브에서 파일을 안전하게 추출합니다."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 68034faafde1
|
||||
---
|
||||
|
||||
# ZIP 추출 {#extract-zip}
|
||||
|
||||
ZIP 아카이브에서 파일을 안전하게 추출합니다. 단일 파일 아카이브는 포함된 파일을 직접 반환하고, 다중 파일 아카이브는 추출된 내용이 담긴 평면 ZIP을 반환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
ZIP 파일이 포함된 multipart form data를 받습니다. settings 필드는 필요하지 않습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. 추출할 `.zip` 파일을 업로드하세요.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive_extracted.zip",
|
||||
"originalSize": 2800000,
|
||||
"processedSize": 3500000
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- `.zip` 파일만 입력으로 허용됩니다.
|
||||
- 아카이브에 파일이 하나만 포함된 경우, 그 파일이 직접 반환됩니다(ZIP으로 감싸지지 않음).
|
||||
- 아카이브에 여러 파일이 포함된 경우, 모든 파일이 루트 레벨로 추출된 평면 ZIP이 반환됩니다(중첩 디렉터리 구조는 평탄화됨).
|
||||
- 내장된 폭탄 보호 기능이 리소스 고갈을 방지하기 위해 과도한 압축 비율이나 파일 개수를 가진 아카이브를 거부합니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "HTML 파일을 PDF로 변환합니다."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6b1cf3067b15
|
||||
---
|
||||
|
||||
# HTML to PDF {#html-to-pdf}
|
||||
|
||||
HTML 파일을 스타일이 적용된 PDF 문서로 변환합니다. 원격 리소스(외부 이미지, 스타일시트, 스크립트)는 개인정보 보호를 위해 비활성화됩니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
HTML 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. HTML 파일을 업로드하면 PDF로 변환됩니다.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
`202 Accepted`을 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적하세요.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.html`, `.htm`.
|
||||
- URL로 참조된 원격 리소스(이미지, 스타일시트, 스크립트)는 개인정보 보호 및 보안을 위해 가져오지 않습니다.
|
||||
- 인라인 스타일과 임베디드 이미지(data URI)는 유지됩니다.
|
||||
- 변환은 서버의 WeasyPrint가 처리합니다.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "JSON과 XML 간 양방향 변환."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 423ba4cd5d09
|
||||
---
|
||||
|
||||
# JSON to XML {#json-to-xml}
|
||||
|
||||
JSON과 XML 형식 간에 양방향으로 변환합니다. JSON 파일을 업로드하여 XML을 얻거나, XML 파일을 업로드하여 JSON을 얻으세요.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
JSON 또는 XML 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | 아니요 | `true` | 들여쓰기와 함께 출력을 보기 좋게 출력 |
|
||||
|
||||
## 요청 예시 {#example-request}
|
||||
|
||||
JSON to 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 to 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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
|
||||
"originalSize": 850,
|
||||
"processedSize": 1200
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#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: 8a4005429508
|
||||
---
|
||||
|
||||
# Markdown to Word {#markdown-to-word}
|
||||
|
||||
Markdown 파일을 Word 문서(DOCX)로 변환하여 제목, 목록, 코드 블록, 기타 서식을 유지합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Markdown 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. Markdown 파일을 업로드하면 DOCX로 변환됩니다.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/README.docx",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 18200
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.md`, `.markdown`.
|
||||
- 이 도구는 결과를 직접 반환하는 빠른(동기) 도구입니다.
|
||||
- 제목, 굵게, 기울임, 링크, 코드 블록, 목록은 Word 스타일로 매핑됩니다.
|
||||
- 변환은 서버의 Pandoc이 처리합니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Markdown 파일을 독립형 HTML 페이지로 변환합니다."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 77ddd3007fa2
|
||||
---
|
||||
|
||||
# Markdown to HTML {#markdown-to-html}
|
||||
|
||||
Markdown 파일을 독립형 HTML 페이지로 변환합니다. 소스에서 참조된 원격 이미지는 출력에 그대로 남습니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Markdown 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#parameters}
|
||||
|
||||
이 도구에는 설정 가능한 매개변수가 없습니다. Markdown 파일을 업로드하면 HTML로 변환됩니다.
|
||||
|
||||
## 요청 예시 {#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}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/notes.html",
|
||||
"originalSize": 3200,
|
||||
"processedSize": 5800
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용 입력 형식: `.md`, `.markdown`.
|
||||
- 이 도구는 결과를 직접 반환하는 빠른(동기) 도구입니다.
|
||||
- 출력은 인라인 스타일이 포함된 자체 완결형 HTML 페이지입니다.
|
||||
- Markdown 소스의 원격 이미지 URL은 그대로 유지되며 가져오지 않습니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Markdown 파일을 스타일이 적용된 PDF로 변환합니다."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9c79fd741afc
|
||||
---
|
||||
|
||||
# Markdown to PDF {#markdown-to-pdf}
|
||||
|
||||
Markdown 파일을 스타일이 적용된 PDF 문서로 변환합니다. 개인정보 보호를 위해 원격 리소스는 비활성화되어 있습니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Markdown 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#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`을(를) 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적할 수 있습니다.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## 참고 사항 {#notes}
|
||||
|
||||
- 허용되는 입력 형식: `.md`, `.markdown`.
|
||||
- 개인정보 보호와 보안을 위해 원격 리소스(URL로 참조된 이미지, 스타일시트)는 가져오지 않습니다.
|
||||
- Markdown은 먼저 HTML로 렌더링된 다음 WeasyPrint를 통해 PDF로 변환됩니다.
|
||||
- 코드 블록, 표, 기타 Markdown 요소는 PDF 출력에서 스타일이 적용됩니다.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "열이 일치하는 여러 CSV 또는 TSV 파일을 하나로 결합합니다."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: bac6a7a9f263
|
||||
---
|
||||
|
||||
# Merge CSVs {#merge-csvs}
|
||||
|
||||
열이 일치하는 여러 CSV 또는 TSV 파일을 하나의 병합된 파일로 결합합니다. 모든 입력 파일은 동일한 열 헤더를 가지고 있어야 합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
두 개 이상의 CSV 파일이 포함된 multipart form data를 받습니다. settings 필드는 필요하지 않습니다.
|
||||
|
||||
## 매개변수 {#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: 1618923be6be
|
||||
---
|
||||
|
||||
# PowerPoint to PDF {#powerpoint-to-pdf}
|
||||
|
||||
PowerPoint 또는 OpenDocument 프레젠테이션을 슬라이드당 한 페이지로 PDF로 변환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
PowerPoint/ODP 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#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`을(를) 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적할 수 있습니다.
|
||||
|
||||
```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: c13f60413116
|
||||
---
|
||||
|
||||
# Split CSV {#split-csv}
|
||||
|
||||
큰 CSV 또는 TSV 파일을 행 수를 기준으로 더 작은 파일로 분할합니다. 분할된 부분들을 담은 ZIP 아카이브를 반환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
CSV 파일과 JSON `settings` 필드가 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#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}
|
||||
|
||||
- 출력은 항상 분할된 CSV 부분들을 담은 ZIP 아카이브이며, 순차적으로 이름이 지정됩니다(예: `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: 8cc287aab9bc
|
||||
---
|
||||
|
||||
# Convert to EPUB {#convert-to-epub}
|
||||
|
||||
Word 문서, Markdown, HTML 또는 일반 텍스트 파일을 EPUB 전자책 형식으로 변환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Word/Markdown/HTML/TXT 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#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`을(를) 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적할 수 있습니다.
|
||||
|
||||
```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: 5f4e4a48c806
|
||||
---
|
||||
|
||||
# Word to PDF {#word-to-pdf}
|
||||
|
||||
Word 문서, OpenDocument 텍스트, RTF 또는 일반 텍스트 파일을 PDF로 변환합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Word/ODT/RTF/TXT 파일이 포함된 multipart form data를 받습니다.
|
||||
|
||||
## 매개변수 {#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`을(를) 반환합니다. `/api/v1/jobs/{jobId}/progress`에서 SSE를 통해 진행 상황을 추적할 수 있습니다.
|
||||
|
||||
```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: 6bf5b9366265
|
||||
---
|
||||
|
||||
# XML to CSV {#xml-to-csv}
|
||||
|
||||
XML 파일에서 반복되는 요소를 추출하여 평면 CSV 표로 만듭니다. 이 도구는 XML 트리에서 첫 번째 객체 배열을 자동으로 찾아 각 요소를 행에 매핑합니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
XML 파일이 포함된 multipart form data를 받습니다. settings 필드는 필요하지 않습니다.
|
||||
|
||||
## 매개변수 {#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 to XML](/ko/tools/files/json-xml) 도구를 사용하세요.
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "YAML과 JSON 간 양방향 변환을 수행합니다."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c24cc0d2741c
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
YAML과 JSON 형식 간 양방향 변환을 수행합니다. YAML 파일을 업로드하면 JSON을 얻고, JSON 파일을 업로드하면 YAML을 얻습니다.
|
||||
|
||||
## API 엔드포인트 {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
YAML 또는 JSON 파일이 포함된 multipart form data를 받습니다. settings 필드는 필요하지 않습니다.
|
||||
|
||||
## 매개변수 {#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