2026-07-11 13:52:47 +08:00
|
|
|
---
|
|
|
|
|
description: "YAML と JSON を双方向で変換します。"
|
2026-07-15 21:55:51 +08:00
|
|
|
i18n_source_hash: ef0c9b633797
|
2026-07-11 13:52:47 +08:00
|
|
|
i18n_provenance: human
|
|
|
|
|
i18n_output_hash: e39453464e79
|
|
|
|
|
---
|
|
|
|
|
|
2026-07-15 21:55:51 +08:00
|
|
|
# YAML / JSON 変換 {#yaml-json}
|
2026-07-11 13:52:47 +08:00
|
|
|
|
|
|
|
|
YAML と JSON 形式を双方向で変換します。YAML ファイルをアップロードすると JSON が得られ、JSON ファイルをアップロードすると YAML が得られます。
|
|
|
|
|
|
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
|
|
|
|
|
|
`POST /api/v1/tools/files/yaml-json`
|
|
|
|
|
|
|
|
|
|
YAML または JSON ファイルを含むマルチパートフォームデータを受け付けます。設定フィールドは不要です。
|
|
|
|
|
|
|
|
|
|
## Parameters {#parameters}
|
|
|
|
|
|
|
|
|
|
このツールに設定可能なパラメータはありません。変換方向は入力ファイルの拡張子によって決定されます。
|
|
|
|
|
|
|
|
|
|
## Example Request {#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 {#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 {#notes}
|
|
|
|
|
|
|
|
|
|
- 変換方向は入力ファイルの拡張子から自動検出されます。`.yaml` または `.yml` は `.json` を生成し、`.json` は `.yaml` を生成します。
|
|
|
|
|
- `.yaml` と `.yml` の両方の拡張子を受け付けます。
|
|
|
|
|
- 複数ドキュメントの YAML ファイルでは最初のドキュメントのみが変換されます。`---` で区切られた追加のドキュメントは無視されます。
|