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: "Crie gráficos de barras, de linhas ou de pizza a partir de dados CSV ou JSON."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: fc015d596192
|
||||
---
|
||||
|
||||
# Criador de Gráficos {#chart-maker}
|
||||
|
||||
Crie gráficos de barras, de linhas ou de pizza a partir de dados CSV ou JSON. Retorna uma imagem PNG do gráfico renderizado.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo CSV ou JSON e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | Não | `"bar"` | Tipo de gráfico: `bar`, `line`, `pie` |
|
||||
| title | string | Não | - | Título do gráfico (máximo 120 caracteres) |
|
||||
| width | integer | Não | `960` | Largura do gráfico em pixels (320-2048) |
|
||||
| height | integer | Não | `540` | Altura do gráfico em pixels (240-1536) |
|
||||
|
||||
## Exemplo de Requisição {#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}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- A entrada deve ser um arquivo `.csv` ou `.json`. Arquivos CSV devem ter uma linha de cabeçalho com os nomes das colunas.
|
||||
- A primeira coluna é usada como rótulo de categoria; a segunda coluna deve ser numérica e fornece os valores dos dados. Apenas duas colunas são usadas.
|
||||
- A entrada JSON deve ser um array de objetos `{label, value}`, ou um objeto simples cujas chaves se tornam rótulos e cujos valores se tornam pontos de dados.
|
||||
- Máximo de 100 pontos de dados. Todos os valores devem ser zero ou maiores.
|
||||
- A saída é sempre uma imagem PNG, independentemente do formato de entrada.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converta entre os formatos Word, OpenDocument, RTF e texto simples."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: df280fed2c6f
|
||||
---
|
||||
|
||||
# Converter Documento {#convert-document}
|
||||
|
||||
Converta documentos entre os formatos Word (DOCX), OpenDocument (ODT), RTF e texto simples usando o LibreOffice.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Word/ODT/RTF/TXT e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Sim | - | Formato de saída: `docx`, `odt`, `rtf`, `txt` |
|
||||
|
||||
## Exemplo de Requisição {#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"}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- A conversão é realizada pelo LibreOffice executando em modo headless no servidor.
|
||||
- Formatações complexas (macros, objetos incorporados) podem não sobreviver à conversão entre formatos.
|
||||
- O formato de saída deve ser diferente do formato de entrada.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converta entre os formatos de apresentação PowerPoint e OpenDocument."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 8fd86e285452
|
||||
---
|
||||
|
||||
# Converter Apresentação {#convert-presentation}
|
||||
|
||||
Converta apresentações entre os formatos PowerPoint (PPTX) e OpenDocument Presentation (ODP).
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo PowerPoint/ODP e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Sim | - | Formato de saída: `pptx`, `odp` |
|
||||
|
||||
## Exemplo de Requisição {#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"}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.pptx`, `.ppt`, `.odp`.
|
||||
- A conversão é realizada pelo LibreOffice executando em modo headless no servidor.
|
||||
- Animações e efeitos de transição podem não ser preservados entre os formatos.
|
||||
- O formato de saída deve ser diferente do formato de entrada.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converta entre os formatos Excel, OpenDocument e CSV."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e5446f4798a2
|
||||
---
|
||||
|
||||
# Converter Planilha {#convert-spreadsheet}
|
||||
|
||||
Converta planilhas entre os formatos Excel (XLSX), OpenDocument Spreadsheet (ODS) e CSV. Pastas de trabalho com várias planilhas exportam a primeira planilha ao converter para CSV.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Excel/ODS/CSV e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Sim | - | Formato de saída: `xlsx`, `ods`, `csv` |
|
||||
|
||||
## Exemplo de Requisição {#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"}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Ao converter uma pasta de trabalho com várias planilhas para CSV, apenas a primeira planilha é exportada.
|
||||
- Fórmulas são avaliadas e exportadas como valores estáticos na saída CSV.
|
||||
- O formato de saída deve ser diferente do formato de entrada.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Agrupe vários arquivos em um único arquivo ZIP."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4cd215cde1e5
|
||||
---
|
||||
|
||||
# Criar ZIP {#create-zip}
|
||||
|
||||
Agrupe vários arquivos de qualquer tipo em um único arquivo ZIP. Nomes de arquivo duplicados são automaticamente diferenciados.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Aceita dados de formulário multipart com dois ou mais arquivos. Nenhum campo de configurações é necessário.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie de 2 a 50 arquivos de qualquer tipo para agrupar.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive.zip",
|
||||
"originalSize": 3500000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Requer entre 2 e 50 arquivos de entrada.
|
||||
- Qualquer tipo de arquivo é aceito; não há restrições quanto ao formato de entrada.
|
||||
- Se vários arquivos compartilharem o mesmo nome, eles são automaticamente diferenciados com sufixos numéricos.
|
||||
- O arquivo de saída usa compressão ZIP padrão (deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Converta entre CSV e Excel (XLSX), em ambas as direções."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 5506331d1793
|
||||
---
|
||||
|
||||
# CSV para Excel {#csv-to-excel}
|
||||
|
||||
Converta entre os formatos CSV e Excel (XLSX) em ambas as direções. Envie um arquivo CSV ou TSV para obter XLSX, ou envie um arquivo XLSX para obter CSV.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo CSV, TSV ou XLSX e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | Não | `1` | Número da planilha a exportar ao converter de XLSX (mín. 1) |
|
||||
|
||||
## Exemplo de Requisição {#example-request}
|
||||
|
||||
CSV para 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 para 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}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data.xlsx",
|
||||
"originalSize": 2048,
|
||||
"processedSize": 5120
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- A direção da conversão é detectada automaticamente pela extensão do arquivo de entrada: `.csv` ou `.tsv` produz `.xlsx`, e `.xlsx` produz `.csv`.
|
||||
- O parâmetro `sheet` só se aplica ao converter de XLSX. Ele seleciona qual planilha exportar.
|
||||
- Arquivos TSV (valores separados por tabulação) são suportados junto com CSV.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Converta entre CSV e JSON, em ambas as direções."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: aa409fc0e337
|
||||
---
|
||||
|
||||
# CSV para JSON {#csv-to-json}
|
||||
|
||||
Converta entre os formatos CSV e JSON em ambas as direções. Envie um arquivo CSV ou TSV para obter um array JSON de objetos, ou envie um array JSON para obter um arquivo CSV.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo CSV, TSV ou JSON e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Não | `true` | Formatar a saída JSON de forma legível, com indentação |
|
||||
|
||||
## Exemplo de Requisição {#example-request}
|
||||
|
||||
CSV para 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 para 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={}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
|
||||
"originalSize": 1500,
|
||||
"processedSize": 2200
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- A direção da conversão é detectada automaticamente pela extensão do arquivo de entrada: `.csv` ou `.tsv` produz `.json`, e `.json` produz `.csv`.
|
||||
- O parâmetro `pretty` afeta apenas a saída JSON. Quando definido como `false`, a saída é uma string JSON compacta de linha única.
|
||||
- A entrada JSON deve ser um array de objetos com chaves consistentes. Cada objeto se torna uma linha, e cada chave se torna um cabeçalho de coluna.
|
||||
- Arquivos TSV (valores separados por tabulação) são suportados junto com CSV.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converta um EPUB para PDF, DOCX, HTML ou Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a8b92fec161f
|
||||
---
|
||||
|
||||
# Converter EPUB {#convert-epub}
|
||||
|
||||
Converta um e-book EPUB para PDF, Word (DOCX), HTML ou Markdown. Recursos remotos dentro do livro não são buscados.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo EPUB e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Sim | - | Formato de saída: `pdf`, `docx`, `html`, `md` |
|
||||
|
||||
## Exemplo de Requisição {#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"}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formato de entrada aceito: `.epub`.
|
||||
- Recursos remotos incorporados no EPUB (imagens e fontes externas) não são buscados por segurança.
|
||||
- A fidelidade das imagens na saída convertida pode variar dependendo da estrutura do EPUB.
|
||||
- A conversão é realizada pelo Pandoc no servidor.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta planilhas para PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9a4648dc3d5a
|
||||
---
|
||||
|
||||
# Excel para PDF {#excel-to-pdf}
|
||||
|
||||
Converta planilhas Excel, OpenDocument ou CSV para PDF. Planilhas largas podem se estender por várias páginas.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Excel/ODS/CSV.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie uma planilha e ela será convertida para PDF.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Planilhas largas podem ser divididas em várias páginas no PDF resultante.
|
||||
- Gráficos e formatação condicional são renderizados na saída PDF.
|
||||
- A conversão é realizada pelo LibreOffice executando em modo headless no servidor.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Extraia arquivos de um arquivo ZIP com segurança, com proteção contra zip bombs."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 08695f8520ba
|
||||
---
|
||||
|
||||
# Extrair ZIP {#extract-zip}
|
||||
|
||||
Extraia arquivos de um arquivo ZIP com segurança. Arquivos ZIP de um único arquivo retornam o arquivo contido diretamente; arquivos ZIP com vários arquivos retornam um ZIP plano com o conteúdo extraído.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo ZIP. Nenhum campo de configurações é necessário.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um arquivo `.zip` para extrair.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Apenas arquivos `.zip` são aceitos como entrada.
|
||||
- Se o arquivo contiver um único arquivo, esse arquivo é retornado diretamente (sem ser empacotado em um ZIP).
|
||||
- Se o arquivo contiver vários arquivos, um ZIP plano é retornado com todos os arquivos extraídos para o nível raiz (a estrutura de diretórios aninhados é achatada).
|
||||
- A proteção interna contra zip bombs rejeita arquivos com taxas de compressão ou quantidades de arquivos excessivas, para evitar o esgotamento de recursos.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta um arquivo HTML para PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 04a86204f35d
|
||||
---
|
||||
|
||||
# HTML para PDF {#html-to-pdf}
|
||||
|
||||
Converta um arquivo HTML em um documento PDF estilizado. Recursos remotos (imagens, folhas de estilo e scripts externos) são desativados por privacidade.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo HTML.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um arquivo HTML e ele será convertido para PDF.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.html`, `.htm`.
|
||||
- Recursos remotos (imagens, folhas de estilo e scripts referenciados por URLs) não são buscados por privacidade e segurança.
|
||||
- Estilos inline e imagens incorporadas (data URIs) são preservados.
|
||||
- A conversão é realizada pelo WeasyPrint no servidor.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Converta entre JSON e XML, em ambas as direções."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d95833b7f730
|
||||
---
|
||||
|
||||
# JSON para XML {#json-to-xml}
|
||||
|
||||
Converta entre os formatos JSON e XML em ambas as direções. Envie um arquivo JSON para obter XML, ou envie um arquivo XML para obter JSON.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo JSON ou XML e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Não | `true` | Formatar a saída de forma legível, com indentação |
|
||||
|
||||
## Exemplo de Requisição {#example-request}
|
||||
|
||||
JSON para 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 para 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}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
|
||||
"originalSize": 850,
|
||||
"processedSize": 1200
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- A direção da conversão é detectada automaticamente pela extensão do arquivo de entrada: `.json` produz `.xml`, e `.xml` produz `.json`.
|
||||
- O parâmetro `pretty` se aplica a ambas as direções. Quando `false`, a saída é compacta, sem indentação.
|
||||
- Atributos XML e estruturas aninhadas são preservados durante a conversão de ida e volta sempre que possível.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta um arquivo Markdown em um documento Word (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f4b965441a55
|
||||
---
|
||||
|
||||
# Markdown para Word {#markdown-to-word}
|
||||
|
||||
Converta um arquivo Markdown em um documento Word (DOCX), preservando títulos, listas, blocos de código e outras formatações.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Markdown.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um arquivo Markdown e ele será convertido para DOCX.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/README.docx",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 18200
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.md`, `.markdown`.
|
||||
- Esta é uma ferramenta rápida (síncrona) que retorna o resultado diretamente.
|
||||
- Títulos, negrito, itálico, links, blocos de código e listas são mapeados para estilos do Word.
|
||||
- A conversão é realizada pelo Pandoc no servidor.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta um arquivo Markdown em uma página HTML independente."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d44985ffda3e
|
||||
---
|
||||
|
||||
# Markdown para HTML {#markdown-to-html}
|
||||
|
||||
Converta um arquivo Markdown em uma página HTML independente. Imagens remotas referenciadas na fonte permanecem inalteradas na saída.
|
||||
|
||||
## Endpoint da API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Markdown.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um arquivo Markdown e ele será convertido para HTML.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/notes.html",
|
||||
"originalSize": 3200,
|
||||
"processedSize": 5800
|
||||
}
|
||||
```
|
||||
|
||||
## Notas {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.md`, `.markdown`.
|
||||
- Esta é uma ferramenta rápida (síncrona) que retorna o resultado diretamente.
|
||||
- A saída é uma página HTML autocontida, com estilos inline.
|
||||
- URLs de imagens remotas na fonte Markdown são preservadas inalteradas e não são buscadas.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta um arquivo Markdown em um PDF estilizado."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 88367614b0e2
|
||||
---
|
||||
|
||||
# Markdown para PDF {#markdown-to-pdf}
|
||||
|
||||
Converta um arquivo Markdown em um documento PDF estilizado. Os recursos remotos ficam desativados por privacidade.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Markdown.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um arquivo Markdown e ele será convertido em PDF.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.md`, `.markdown`.
|
||||
- Recursos remotos (imagens, folhas de estilo referenciadas por URLs) não são buscados, por privacidade e segurança.
|
||||
- O Markdown é primeiro renderizado em HTML e depois convertido em PDF via WeasyPrint.
|
||||
- Blocos de código, tabelas e outros elementos Markdown são estilizados na saída em PDF.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Combine vários arquivos CSV ou TSV com colunas correspondentes em um só."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c564dc63c256
|
||||
---
|
||||
|
||||
# Mesclar CSVs {#merge-csvs}
|
||||
|
||||
Combine vários arquivos CSV ou TSV com colunas correspondentes em um único arquivo mesclado. Todos os arquivos de entrada devem ter os mesmos cabeçalhos de coluna.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Aceita dados de formulário multipart com dois ou mais arquivos CSV. Não é necessário nenhum campo de configurações.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie de 2 a 20 arquivos CSV ou TSV com cabeçalhos de coluna correspondentes.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Requer entre 2 e 20 arquivos de entrada.
|
||||
- Todos os arquivos devem compartilhar os mesmos cabeçalhos de coluna. A mesclagem falhará se as colunas não corresponderem.
|
||||
- A linha de cabeçalho é incluída uma vez na saída; as linhas de dados de todos os arquivos são concatenadas na ordem de envio.
|
||||
- Arquivos CSV e TSV são aceitos, mas todos os arquivos em uma única requisição devem usar o mesmo delimitador.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta apresentações em PDF."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 479ac15b53a7
|
||||
---
|
||||
|
||||
# PowerPoint para PDF {#powerpoint-to-pdf}
|
||||
|
||||
Converta apresentações do PowerPoint ou OpenDocument em PDF, com um slide por página.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo PowerPoint/ODP.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie uma apresentação e ela será convertida em PDF.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.pptx`, `.ppt`, `.odp`.
|
||||
- Cada slide se torna uma página no PDF.
|
||||
- A conversão é feita pelo LibreOffice em modo headless no servidor.
|
||||
- Animações e transições não são incluídas na saída em PDF.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Divida um CSV em arquivos menores por contagem de linhas."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 477c07b546cd
|
||||
---
|
||||
|
||||
# Dividir CSV {#split-csv}
|
||||
|
||||
Divida um arquivo CSV ou TSV grande em arquivos menores por contagem de linhas. Retorna um arquivo ZIP contendo as partes.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo CSV e um campo JSON `settings`.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | integer | Não | `1000` | Número de linhas de dados por arquivo de saída (1-1.000.000) |
|
||||
| keepHeader | boolean | Não | `true` | Repetir a linha de cabeçalho em cada arquivo de saída |
|
||||
|
||||
## Exemplo de Requisição {#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}'
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- A saída é sempre um arquivo ZIP contendo as partes CSV divididas, nomeadas sequencialmente (por exemplo, `part-1.csv`, `part-2.csv`).
|
||||
- Quando `keepHeader` é `true`, cada parte inclui a linha de cabeçalho original, para que cada arquivo possa ser usado de forma independente.
|
||||
- Arquivos CSV e TSV são aceitos como entrada.
|
||||
- A contagem de linhas refere-se apenas às linhas de dados; a linha de cabeçalho não é contada.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta arquivos Word, Markdown, HTML ou texto simples em EPUB."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 23334a058404
|
||||
---
|
||||
|
||||
# Converter para EPUB {#convert-to-epub}
|
||||
|
||||
Converta documentos do Word, Markdown, HTML ou arquivos de texto simples no formato de e-book EPUB.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Word/Markdown/HTML/TXT.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um documento e ele será convertido em EPUB.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.docx`, `.md`, `.html`, `.txt`.
|
||||
- A saída EPUB segue a especificação EPUB 3.
|
||||
- Os títulos no documento de origem são usados para gerar o sumário.
|
||||
- A conversão é feita pelo Pandoc no servidor.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converta documentos do Word em PDF."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7b418cfc42b2
|
||||
---
|
||||
|
||||
# Word para PDF {#word-to-pdf}
|
||||
|
||||
Converta documentos do Word, texto OpenDocument, RTF ou arquivos de texto simples em PDF.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo Word/ODT/RTF/TXT.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. Envie um documento e ele será convertido em PDF.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
Retorna `202 Accepted`. Acompanhe o progresso via SSE em `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Formatos de entrada aceitos: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- A conversão é feita pelo LibreOffice em modo headless no servidor.
|
||||
- As fontes incorporadas ao documento são usadas quando disponíveis; caso contrário, fontes do sistema são substituídas.
|
||||
- Cabeçalhos, rodapés, tabelas e imagens são preservados na saída em PDF.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Extraia elementos repetidos de um XML para uma tabela CSV."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6d89acb448c5
|
||||
---
|
||||
|
||||
# XML para CSV {#xml-to-csv}
|
||||
|
||||
Extraia elementos repetidos de um arquivo XML para uma tabela CSV plana. A ferramenta encontra automaticamente o primeiro array de objetos na árvore XML e mapeia cada elemento para uma linha.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo XML. Não é necessário nenhum campo de configurações.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. O elemento repetido é detectado automaticamente a partir da estrutura do XML.
|
||||
|
||||
## Exemplo de Requisição {#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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- Apenas arquivos `.xml` são aceitos como entrada.
|
||||
- A ferramenta varre a árvore XML em busca do primeiro conjunto repetido de elementos irmãos e os usa como linhas.
|
||||
- Cada nome único de elemento filho ou atributo se torna um cabeçalho de coluna do CSV.
|
||||
- Esta é uma conversão de mão única. Para conversão bidirecional entre JSON/XML, use a ferramenta [JSON para XML](/pt-BR/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "Converta entre YAML e JSON, nos dois sentidos."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7b61b929445e
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Converta entre os formatos YAML e JSON nos dois sentidos. Envie um arquivo YAML para obter JSON, ou envie um arquivo JSON para obter YAML.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Aceita dados de formulário multipart com um arquivo YAML ou JSON. Não é necessário nenhum campo de configurações.
|
||||
|
||||
## Parâmetros {#parameters}
|
||||
|
||||
Esta ferramenta não tem parâmetros configuráveis. O sentido da conversão é determinado pela extensão do arquivo de entrada.
|
||||
|
||||
## Exemplo de Requisição {#example-request}
|
||||
|
||||
YAML para 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 para 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"
|
||||
```
|
||||
|
||||
## Exemplo de Resposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Observações {#notes}
|
||||
|
||||
- O sentido da conversão é detectado automaticamente pela extensão do arquivo de entrada: `.yaml` ou `.yml` produz `.json`, e `.json` produz `.yaml`.
|
||||
- Ambas as extensões `.yaml` e `.yml` são aceitas.
|
||||
- Apenas o primeiro documento de um arquivo YAML com múltiplos documentos é convertido; documentos adicionais separados por `---` são ignorados.
|
||||
Reference in New Issue
Block a user