{"info":{"_postman_id":"057b9fc3-8398-4bd7-85b3-34321d7e98df","name":"Excel > Socket","description":"

Documentação de APIs

Esta coleção contém as APIs disponíveis:

1. Converter CSV para XLSX

API para conversão de CSV em texto para arquivo XLSX, é retornado um link para download do documento.

2. API Fetch - Socket que envia o excel para a maquina remota

API para download de arquivos Excel e broadcast via WebSocket.

Mantido por: FreedomAI

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Documentação de APIs","slug":"documentacao-de-apis"}],"owner":"50660444","collectionId":"057b9fc3-8398-4bd7-85b3-34321d7e98df","publishedId":"2sB3dQupY7","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FFdf29"},"publishDate":"2025-12-08T23:00:04.000Z"},"item":[{"name":"1. Gerar excel (link)","item":[{"name":"Converter CSV para XLSX","id":"6ce39772-f8e4-4b3e-891e-557b90cc0c33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Tipo de conteúdo JSON

\n"}],"body":{"mode":"raw","raw":"{\n \"csv\": \"produto;preco;estoque\\nCamiseta;59.9;120\\nCalça;129.9;80\\nTênis;199.9;45\"\n}","options":{"raw":{"language":"json"}}},"url":"https://send.freedomai.dev.br/brasanitas/doc/csv-to-xlsx","description":"

Converter CSV para XLSX

Este endpoint recebe um CSV em formato texto e retorna uma URL para download do arquivo XLSX gerado.

Campos aceitos no body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
`csv`	string	Sim*	CSV completo em texto
`csvText`	string	Sim*	Alias opcional para o CSV

*Um dos dois campos é obrigatório.

Delimitadores suportados

Ponto e vírgula (;)
Vírgula (,)

Exemplo de CSV válido

produto;preco;estoque\nCamiseta;59.9;120\nCalça;129.9;80\n

Respostas

✅ 200 - Sucesso

Retorna objeto com URL de download.

❌ 400 - CSV ausente

Campo csv ou csvText não foi enviado.

❌ 500 - Erro interno

Falha ao processar a conversão.

\n","urlObject":{"protocol":"https","path":["brasanitas","doc","csv-to-xlsx"],"host":["send","freedomai","dev","br"],"query":[],"variable":[]}},"response":[{"id":"e8cc272c-6e97-4b38-8b9f-e7e638a14440","name":"200 - XLSX Gerado com Sucesso","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"csv\": \"produto;preco;estoque\\nCamiseta;59.9;120\\nCalça;129.9;80\"\n}"},"url":"http://179.127.151.101:3607/csv-to-xlsx"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"XLSX gerado com sucesso\",\n \"filename\": \"csv-1698425600000.xlsx\",\n \"downloadUrl\": \"http://179.127.151.101:3607/xlsx/csv-1698425600000.xlsx\",\n \"size\": 5321\n}"},{"id":"4ca2f3b5-0485-4365-9d75-56417e43c823","name":"400 - CSV Ausente","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":"http://179.127.151.101:3607/csv-to-xlsx"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"Envie o CSV no campo \\\"csv\\\" ou \\\"csvText\\\" do JSON.\"\n}"},{"id":"3b7448a0-c76c-422a-8940-2260fef28602","name":"500 - Erro na Conversão","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"csv\": \"dados_invalidos\"\n}"},"url":"http://179.127.151.101:3607/csv-to-xlsx"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"Falha ao gerar XLSX.\"\n}"}],"_postman_id":"6ce39772-f8e4-4b3e-891e-557b90cc0c33"},{"name":"Converter CSV para XLSX - Usando csvText (alias)","id":"d967f0d4-0899-4ec8-84b3-93c705bbda18","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Tipo de conteúdo JSON

\n"}],"body":{"mode":"raw","raw":"{\n \"csvText\": \"nome,idade,cidade\\nJoão,30,São Paulo\\nMaria,25,Rio de Janeiro\\nPedro,35,Belo Horizonte\"\n}","options":{"raw":{"language":"json"}}},"url":"https://send.freedomai.dev.br/brasanitas/doc/csv-to-xlsx","description":"

Converter CSV usando campo csvText

Exemplo alternativo usando o campo csvText ao invés de csv.

Ambos os campos são aceitos e funcionam da mesma forma.

\n","urlObject":{"protocol":"https","path":["brasanitas","doc","csv-to-xlsx"],"host":["send","freedomai","dev","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"d967f0d4-0899-4ec8-84b3-93c705bbda18"},{"name":"Recuperar XLSX gerado","id":"ba8c9485-0e1b-4883-843b-5a3c36b88cef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://send.freedomai.dev.br/brasanitas/doc/xlsx/[filename].xlsx","description":"

Download do arquivo XLSX

Faz o download do arquivo XLSX gerado anteriormente.

Parâmetros de URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Descrição
`filename`	string	Nome do arquivo retornado na conversão

Headers de Resposta (200)

Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\nContent-Disposition: attachment; filename=\"csv-1698425600000.xlsx\"\n

Respostas

✅ 200 - Download do arquivo

Retorna o arquivo binário XLSX.

❌ 404 - Arquivo não encontrado

O arquivo solicitado não existe ou expirou.

❌ 400 - Nome inválido

O nome do arquivo contém caracteres inválidos.

\n","urlObject":{"protocol":"https","path":["brasanitas","doc","xlsx","[filename].xlsx"],"host":["send","freedomai","dev","br"],"query":[],"variable":[]}},"response":[{"id":"04692485-dcc1-4ff5-8697-a4b42181430f","name":"404 - Arquivo Não Encontrado","originalRequest":{"method":"GET","header":[],"url":"http://179.127.151.101:3607/xlsx/arquivo-inexistente.xlsx"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"Arquivo não encontrado.\"\n}"},{"id":"369020c2-d413-4f62-97b1-babef61e6456","name":"400 - Nome de Arquivo Inválido","originalRequest":{"method":"GET","header":[],"url":"http://179.127.151.101:3607/xlsx/../../../etc/passwd"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"Arquivo inválido.\"\n}"}],"_postman_id":"ba8c9485-0e1b-4883-843b-5a3c36b88cef"}],"id":"5909598c-0460-45da-8e87-256906ab1b8f","description":"

Gerar excel

API mínima que converte um CSV enviado como texto para XLSX e devolve uma URL para download.

Endpoints disponíveis

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Endpoint	Descrição
POST	`/csv-to-xlsx`	Converte CSV para XLSX
GET	`/xlsx/{filename}`	Download do arquivo gerado

","_postman_id":"5909598c-0460-45da-8e87-256906ab1b8f"},{"name":"2. Enviar para maquina remota (Socket)","item":[{"name":"Broadcast XLSX","id":"0d0f2a99-cb0d-4556-b057-b3a53ed26416","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Tipo de conteúdo JSON

\n"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://servidor.com/arquivo.xlsx\"\n}","options":{"raw":{"language":"json"}}},"url":"https://send.freedomai.dev.br/brasanitas/socket/fetch","description":"

fetchAndBroadcast

Este endpoint realiza as seguintes operações:

Recebe uma URL de download direto de um arquivo Excel
Faz download do arquivo diretamente (sem redirecionamentos)
Salva o arquivo na pasta configurada da máquina remota
Notifica todos os clientes WebSocket conectados em ws://localhost:1213
Retorna confirmação do download e broadcast

⚠️ Requisito Obrigatório

A URL enviada precisa ser um link direto, ou seja:

✅ Deve apontar para o arquivo Excel diretamente
❌ Não pode depender de botão de download
❌ Não pode abrir uma página HTML intermediária
✅ Deve permitir download imediato com HTTP GET

Exemplos de URLs válidas

https://servidor.com/arquivo.xlsx\nhttps://dominio.com/downloads/relatorio.xls\nhttps://exemplo.com/api/export.xlsx?token=123\n

Exemplos de URLs inválidas

https://drive.google.com/file/d/xxx/view  (página de preview)\nhttps://site.com/download-page            (página com botão)\n

🔐 Autenticação

Este endpoint requer autenticação via Bearer Token.

Authorization: {{vault:bearer-token}}\n

Respostas

✅ 200 - Sucesso

Arquivo baixado, salvo e broadcast enviado.

❌ 400 - URL ausente

Campo url não foi enviado no body.

❌ 500 - Falha no download

Erro ao baixar ou salvar o arquivo.

\n","urlObject":{"protocol":"https","path":["brasanitas","socket","fetch"],"host":["send","freedomai","dev","br"],"query":[],"variable":[]}},"response":[{"id":"46a7af4a-8354-4864-aabd-bd873fa4ca94","name":"200 - Sucesso","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"{{vault:bearer-token}}"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://servidor.com/arquivo.xlsx\"\n}"},"url":"http://179.127.151.101:5000/fetch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Excel baixado, salvo na máquina remota e publicado aos clientes WebSocket.\",\n \"clients\": 3\n}"},{"id":"7d8221fd-9e68-4c54-9aac-3df80a7c5475","name":"400 - URL Ausente","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"{{vault:bearer-token}}"}],"body":{"mode":"raw","raw":"{}"},"url":"http://179.127.151.101:5000/fetch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"URL is required\"\n}"},{"id":"26905c61-d85b-48db-95dc-8e6cb1a9b69c","name":"500 - Falha no Download","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"{{vault:bearer-token}}"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://dominio-invalido.xyz/arquivo.xlsx\"\n}"},"url":"http://179.127.151.101:5000/fetch"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Failed to fetch URL\",\n \"message\": \"getaddrinfo ENOTFOUND dominio-invalido.xyz\"\n}"},{"id":"5e8abace-aaa5-48d5-9b62-a61adab4180b","name":"401 - Não Autorizado (Token inválido)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"{{vault:bearer-token}}"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://servidor.com/arquivo.xlsx\"\n}"},"url":"http://179.127.151.101:5000/fetch"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"}],"_postman_id":"0d0f2a99-cb0d-4556-b057-b3a53ed26416"}],"id":"e3b93643-6592-4804-b214-74082edd6887","description":"

Enviar excel para maquina remota

API para download de arquivos Excel via URL direta e notificação automática via WebSocket.

🔐 Autenticação

Todos os endpoints desta API requerem autenticação via Bearer Token:

Authorization: {{vault:bearer-token}}\n\n

WebSocket

Se a resposta for positiva, a planilha foi enviada e baixada em todas as maquinas configuradas.

Endpoints disponíveis

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Endpoint	Descrição
POST	`/fetch`	Download de Excel e broadcast

","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"_postman_id":"e3b93643-6592-4804-b214-74082edd6887"}],"event":[{"listen":"prerequest","script":{"id":"62aded2b-9b92-428a-8845-3cf8722edd16","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"93df7e06-146c-4758-8fcd-77ae2e08fc92","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"csv_server","value":""},{"key":"fetch_server","value":""},{"key":"bearer_token","value":""}]}