Ir para o conteúdo principal

Encontre sua próxima ferramenta

PainelApp para Android
Idioma
Aparência
API para desenvolvedores e automação

Crie automação de documentos sobre o MAXScanner

Uma API REST para converter, mesclar e aplicar OCR em documentos, com suporte completo a Zapier, Make e n8n. Comece grátis, sem cartão de crédito.

Início rápido

  1. Faça login e abra seu Painel; depois vá em API e automação → Chaves de API → Criar nova chave.
  2. Copie a chave (exibida uma única vez); ela tem este formato: mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. Envie-a como token Bearer em todas as requisições: Authorization: Bearer YOUR_API_KEY.
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
AO VIVO

Experimente a API agora

Isto chama o endpoint real /api/v1/sandbox/convert e converte um pequeno documento de demonstração gerado na hora. Não precisa de chave de API, e só funciona a partir desta página em maxscanner.app, então não pode ser incorporado nem coletado em outro lugar.

Limites de uso e créditos gratuitos

PLANO GRATUITO

10 / dia

e 100 requisições por mês, grátis para sempre. Sem cartão de crédito.

PLANOS PAGOS

2.000 – ilimitado

Starter (2.000 créditos/mês), Pro (10.000/mês), Business (ilimitado).

Os planos pagos consomem créditos por operação:

Converter — 2 créditosMesclar — 1 créditoOCR — 3 créditosConsulta de uso — grátis

Endpoints

URL base: https://maxscanner.app/api/v1

GET/healthgrátis, sem chave

Verifica se a API está no ar; útil para a etapa “Testar conexão” do Zapier.

RESPOSTA

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usagegrátis

Veja seu plano atual e a cota restante da chave enviada.

RESPOSTA

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 créditos

Converte um documento de uma URL para outro formato (pdf, docx, xlsx, pptx, txt, html, png, ...).

CORPO DA REQUISIÇÃO

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

RESPOSTA

Arquivo binário (o Content-Type corresponde ao formato solicitado)
POST/merge1 crédito

Mescla de 2 a 20 PDFs (informados como URLs) em um único PDF, na ordem fornecida.

CORPO DA REQUISIÇÃO

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

RESPOSTA

Arquivo binário (application/pdf)
POST/ocr3 créditos

Extrai texto de uma imagem ou PDF digitalizado com OCR real; funciona até sem camada de texto.

CORPO DA REQUISIÇÃO

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

RESPOSTA

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 crédito

Envia um arquivo PARA a sua biblioteca MAXScanner a partir de uma automação: o sentido oposto ao de /convert.

CORPO DA REQUISIÇÃO

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

RESPOSTA

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribegrátis

Registra uma URL de webhook para receber eventos futuros de um tipo. Veja “Webhooks, Zapier e n8n” abaixo.

CORPO DA REQUISIÇÃO

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

RESPOSTA

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribegrátis

Remove uma assinatura de webhook pelo id.

CORPO DA REQUISIÇÃO

{ "id": "..." }

RESPOSTA

{ "success": true }
GET/hooksgrátis

Lista suas assinaturas de webhook ativas, com o status da última entrega de cada uma.

RESPOSTA

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert ACEITA (NÃO SÓ FORMATOS DO OFFICE)

Word / Excel / PowerPointPDFo clássico “Office para PDF”
PDFWord / texto simples / HTML“PDF para Office”
PDFImagem PNG / JPGuma imagem por página
Imagem PNG / JPGPDFtransforma uma imagem em página PDF

Zapier, Make, n8n e webhooks

Conecte o app MAXScanner para Android a mais de 5.000 aplicativos. No app, abra Configurações → Zapier e automação (ou o bloco API e automação em Ferramentas) para assinar e obter sua chave de integração; depois use-a como chave de API do MAXScanner na etapa de conexão do Zapier. A mesma chave também funciona para as chamadas REST diretas acima.

GATILHOS DISPONÍVEIS

Novo documento digitalizadoscan.createdTodos os planos

Dispara sempre que um novo documento é digitalizado no app.

Nova exportação em PDFpdf.exportedTodos os planos

Dispara quando um grupo de documentos é exportado para PDF.

Nova digitalização com geolocalizaçãogeotag.capturedPro e superiores

Dispara para digitalizações marcadas com dados de localização (endereço, cidade, coordenadas).

Nova captura com carimbo de data e horatimestamp.capturedBusiness

Dispara para capturas com carimbo de data e hora.

Novo texto de OCR extraídoocr.completedPro e superiores

Dispara quando o texto de OCR no dispositivo fica disponível para uma digitalização.

Novo código QR lidoqr.scannedTodos os planos

Dispara assim que um código QR é lido no app, com o texto decodificado.

Make.com

Cenários de automação visual

n8n

Automação de fluxos auto-hospedada

Webhooks

Callbacks HTTP diretos para todo o resto

As três plataformas funcionam da mesma forma aqui: elas fornecem uma URL e você pede ao MAXScanner para fazer POST nela via /hooks/subscribe. Ainda não há um app nativo do Zapier para instalar: é usada a ação genérica Webhooks by Zapier do próprio Zapier, que já funciona hoje.

⚡ Zapier passo a passo

  1. Crie um Zap → procure o app Webhooks by Zapier → escolha o evento de gatilho Catch Hook.
  2. O Zapier mostra uma URL de webhook personalizada (ex.: https://hooks.zapier.com/hooks/catch/...). Copie-a.
  3. Chame uma vez o /hooks/subscribe do MAXScanner com essa URL e o evento desejado (veja o exemplo de curl abaixo).
  4. De volta ao Zapier, gere um evento de teste no app (por exemplo, digitalize um documento): a etapa Catch Hook deve mostrar dados de exemplo. Continue montando a ação do seu Zap a partir daí (Google Drive, Sheets, Slack, e-mail, o que precisar).

🔄 n8n passo a passo

  1. Adicione um nó de gatilho Webhook a um novo fluxo. Configure-o para aceitar requisições POST.
  2. Copie a Production URL do nó (ative o fluxo antes para que ele esteja no ar).
  3. Chame /hooks/subscribe com essa URL e o evento escolhido.
  4. Gere um evento de teste no app: o nó Webhook captura o payload, pronto para ser ligado ao resto do seu fluxo.

Assinar via curl

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

Pronto para automatizar seus documentos?

Crie uma chave de API gratuita: 10 requisições por dia, 100 por mês, sem cartão.