{"openapi":"3.1.0","info":{"title":"easyPDF API","description":"\nAPI REST do **easyPDF** para integrar as ferramentas de PDF e a **assinatura digital ICP-Brasil** aos sistemas da\nsua organização (ERP, protocolo, gestão de documentos, RPA…). Disponível no plano **Institucional**.\n\n## Autenticação\nCrie uma chave em **easypdf.com.br/dashboard/api** e envie em toda requisição:\n\n```\nAuthorization: Bearer epdf_live_SUA_CHAVE\n```\n(ou no cabeçalho `X-API-Key`). A chave aparece **uma única vez**; guarde-a como uma senha e revogue no painel se\nela vazar. As operações são registradas em nome da organização e do usuário que criou a chave.\n\n## Formato\n- Envio de arquivos em `multipart/form-data`; respostas de ferramentas devolvem o **arquivo** (PDF, ZIP, DOCX,\n  imagens) e as demais, JSON.\n- Páginas são numeradas **a partir de 1**.\n- Erros sempre no formato:\n```json\n{\"error\": {\"status\": 413, \"code\": \"file_too_large\", \"message\": \"Arquivo muito grande…\"}}\n```\n\n## Limites\n- **120 requisições por minuto por chave** (resposta `429` com `Retry-After`).\n- Plano Institucional: arquivos, operações e assinaturas sem limite mensal; envio de até 1 GB por requisição.\n- Tarefas assíncronas (tradução): o resultado fica disponível por **2 horas**.\n\n## Privacidade\nOs arquivos são processados e apagados automaticamente (até 2 horas depois). Na tradução, o texto do documento é\nenviado ao serviço de tradução do Google.\n","contact":{"name":"easyPDF","url":"https://easypdf.com.br/api","email":"contato@easypdf.com.br"},"version":"1.0.0"},"servers":[{"url":"/api/v1"},{"url":"https://easypdf.com.br/api/v1","description":"Produção"}],"paths":{"/me":{"get":{"tags":["Conta"],"summary":"Dados da chave e da organização","operationId":"me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/usage":{"get":{"tags":["Conta"],"summary":"Uso da API da organização","operationId":"usage_usage_get","security":[{"ChaveAPI":[]},{"XApiKey":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"description":"Período em dias","default":30,"title":"Days"},"description":"Período em dias"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pdf/merge":{"post":{"tags":["PDF"],"summary":"Juntar PDFs","operationId":"pdf_merge_pdf_merge_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_merge_pdf_merge_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/split":{"post":{"tags":["PDF"],"summary":"Dividir PDF","operationId":"pdf_split_pdf_split_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_split_pdf_split_post"}}},"required":true},"responses":{"200":{"description":"Arquivo ZIP","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/compress":{"post":{"tags":["PDF"],"summary":"Comprimir PDF","operationId":"pdf_compress_pdf_compress_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_compress_pdf_compress_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/rotate":{"post":{"tags":["PDF"],"summary":"Girar páginas","operationId":"pdf_rotate_pdf_rotate_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_rotate_pdf_rotate_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/remove-pages":{"post":{"tags":["PDF"],"summary":"Excluir páginas","operationId":"pdf_remove_pages_pdf_remove_pages_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_remove_pages_pdf_remove_pages_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/reorder":{"post":{"tags":["PDF"],"summary":"Reordenar páginas","operationId":"pdf_reorder_pdf_reorder_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_reorder_pdf_reorder_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/protect":{"post":{"tags":["PDF"],"summary":"Proteger com senha (AES-256)","operationId":"pdf_protect_pdf_protect_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_protect_pdf_protect_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/unlock":{"post":{"tags":["PDF"],"summary":"Remover senha","operationId":"pdf_unlock_pdf_unlock_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_unlock_pdf_unlock_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/watermark":{"post":{"tags":["PDF"],"summary":"Marca d'água de texto","operationId":"pdf_watermark_pdf_watermark_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_watermark_pdf_watermark_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/page-numbers":{"post":{"tags":["PDF"],"summary":"Numerar páginas","operationId":"pdf_page_numbers_pdf_page_numbers_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_page_numbers_pdf_page_numbers_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/pdf/redact":{"post":{"tags":["PDF"],"summary":"Censurar áreas (tarja definitiva)","operationId":"pdf_redact_pdf_redact_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_redact_pdf_redact_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/convert/pdf-to-docx":{"post":{"tags":["Conversão"],"summary":"PDF para Word (.docx)","operationId":"convert_pdf_to_docx_convert_pdf_to_docx_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_pdf_to_docx_convert_pdf_to_docx_post"}}},"required":true},"responses":{"200":{"description":"Documento Word","content":{"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/convert/pdf-to-images":{"post":{"tags":["Conversão"],"summary":"PDF para imagens (ZIP)","operationId":"convert_pdf_to_images_convert_pdf_to_images_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_pdf_to_images_convert_pdf_to_images_post"}}},"required":true},"responses":{"200":{"description":"Arquivo ZIP","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/convert/images-to-pdf":{"post":{"tags":["Conversão"],"summary":"Imagens para PDF","operationId":"convert_images_to_pdf_convert_images_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_images_to_pdf_convert_images_to_pdf_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/convert/office-to-pdf":{"post":{"tags":["Conversão"],"summary":"Word, Excel, PowerPoint ou ODF para PDF","operationId":"convert_office_to_pdf_convert_office_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_office_to_pdf_convert_office_to_pdf_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/convert/pdf-to-pdfa":{"post":{"tags":["Conversão"],"summary":"PDF para PDF/A (arquivamento)","operationId":"convert_pdf_to_pdfa_convert_pdf_to_pdfa_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_pdf_to_pdfa_convert_pdf_to_pdfa_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/ocr":{"post":{"tags":["OCR"],"summary":"OCR: tornar PDF escaneado pesquisável","operationId":"run_ocr_ocr_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_run_ocr_ocr_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/sign":{"post":{"tags":["Assinatura digital"],"summary":"Assinar um PDF (ICP-Brasil A1)","description":"Assinatura **PAdES** com certificado **ICP-Brasil A1**: envie o arquivo `.pfx` com a senha, ou use o certificado salvo na conta de quem criou a chave (`use_saved_certificate=true`). Assinaturas anteriores do PDF continuam válidas (assinatura incremental). Com `visible=true`, o carimbo traz nome, data e QR Code de verificação; posição e tamanho em % da página. `appearance` aceita o JSON de aparência do site (modelo `completo`, `carimbo`, `rubrica` ou `compacto`, cores e campos). O cabeçalho `X-Verify-Code` traz o código de verificação, quando houver.","operationId":"sign_pdf_sign_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_sign_pdf_sign_post"}}},"required":true},"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/sign/batch":{"post":{"tags":["Assinatura digital"],"summary":"Assinar vários PDFs (até 50) — ZIP","description":"Mesmo certificado, aparência e posição em todos. O ZIP traz os PDFs assinados; se algum documento não puder ser assinado (senha, arquivo corrompido), ele não impede os outros e entra em `relatorio.txt`. O cabeçalho `X-Lote-Resumo` traz `{\"ok\": n, \"erros\": n}`.","operationId":"sign_batch_sign_batch_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_sign_batch_sign_batch_post"}}},"required":true},"responses":{"200":{"description":"Arquivo ZIP","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/signatures/inspect":{"post":{"tags":["Assinatura digital"],"summary":"Verificar as assinaturas de um PDF","description":"Lista as assinaturas digitais do PDF com titular, data, integridade (o documento não foi alterado depois de assinar), cobertura, carimbo do tempo e se o certificado é ICP-Brasil. A confiança da cadeia não é validada no servidor (`trust_verified=false`).","operationId":"signatures_inspect_signatures_inspect_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_signatures_inspect_signatures_inspect_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/translate":{"post":{"tags":["Tradução"],"summary":"Traduzir PDF mantendo o layout","description":"Cria uma **tarefa assíncrona**: a resposta traz `job_id`; acompanhe em `GET /jobs/{job_id}` e baixe em `GET /jobs/{job_id}/result` quando `status` for `done`. Páginas escaneadas passam por OCR. Idiomas: veja `GET /translate/languages`.","operationId":"translate_start_translate_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_translate_start_translate_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/translate/languages":{"get":{"tags":["Tradução"],"summary":"Idiomas da tradução","operationId":"translate_languages_translate_languages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ChaveAPI":[]},{"XApiKey":[]}]}},"/jobs/{job_id}":{"get":{"tags":["Tarefas"],"summary":"Estado de uma tarefa","operationId":"job_status_jobs__job_id__get","security":[{"ChaveAPI":[]},{"XApiKey":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/jobs/{job_id}/result":{"get":{"tags":["Tarefas"],"summary":"Baixar o resultado de uma tarefa","operationId":"job_result_jobs__job_id__result_get","security":[{"ChaveAPI":[]},{"XApiKey":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"PDF resultante","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/verify/{code}":{"get":{"tags":["Verificação"],"summary":"Consultar um registro de assinatura (QR Code)","operationId":"verify_record_verify__code__get","security":[{"ChaveAPI":[]},{"XApiKey":[]}],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_convert_images_to_pdf_convert_images_to_pdf_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"JPG, PNG, BMP, TIFF ou WEBP, na ordem"}},"type":"object","required":["files"],"title":"Body_convert_images_to_pdf_convert_images_to_pdf_post"},"Body_convert_office_to_pdf_convert_office_to_pdf_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":".docx, .doc, .xlsx, .xls, .pptx, .odt, .ods…"}},"type":"object","required":["file"],"title":"Body_convert_office_to_pdf_convert_office_to_pdf_post"},"Body_convert_pdf_to_docx_convert_pdf_to_docx_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"}},"type":"object","required":["file"],"title":"Body_convert_pdf_to_docx_convert_pdf_to_docx_post"},"Body_convert_pdf_to_images_convert_pdf_to_images_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"format":{"type":"string","title":"Format","description":"`jpg` ou `png`","default":"jpg"},"dpi":{"type":"integer","title":"Dpi","description":"Resolução (72 a 300)","default":150}},"type":"object","required":["file"],"title":"Body_convert_pdf_to_images_convert_pdf_to_images_post"},"Body_convert_pdf_to_pdfa_convert_pdf_to_pdfa_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"level":{"type":"string","title":"Level","description":"`1b`, `2b` ou `3b`","default":"2b"}},"type":"object","required":["file"],"title":"Body_convert_pdf_to_pdfa_convert_pdf_to_pdfa_post"},"Body_pdf_compress_pdf_compress_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"}},"type":"object","required":["file"],"title":"Body_pdf_compress_pdf_compress_post"},"Body_pdf_merge_pdf_merge_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"Dois ou mais PDFs, na ordem em que devem ficar"}},"type":"object","required":["files"],"title":"Body_pdf_merge_pdf_merge_post"},"Body_pdf_page_numbers_pdf_page_numbers_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"position":{"type":"string","title":"Position","description":"`baixo-centro`, `baixo-direita`, `baixo-esquerda`, `cima-centro`, `cima-direita` ou `cima-esquerda`","default":"baixo-centro"},"start":{"type":"integer","title":"Start","description":"Número da primeira página","default":1},"format":{"type":"string","title":"Format","description":"Modelo: `{n}` = número da página, `{total}` (ou `{t}`) = total. Ex.: `Página {n} de {total}`","default":"{n}"},"size":{"type":"integer","title":"Size","description":"Tamanho da letra","default":10},"color":{"type":"string","title":"Color","description":"Cor em hexadecimal","default":"#000000"},"margin":{"type":"integer","title":"Margin","description":"Distância da borda (pt)","default":20}},"type":"object","required":["file"],"title":"Body_pdf_page_numbers_pdf_page_numbers_post"},"Body_pdf_protect_pdf_protect_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"password":{"type":"string","title":"Password","description":"Senha para abrir o PDF"}},"type":"object","required":["file","password"],"title":"Body_pdf_protect_pdf_protect_post"},"Body_pdf_redact_pdf_redact_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"areas":{"type":"string","title":"Areas","description":"JSON: `[{\"page\": 1, \"x\": 10, \"y\": 20, \"w\": 30, \"h\": 5}]` — página a partir de 1; x, y, w, h em % da página"}},"type":"object","required":["file","areas"],"title":"Body_pdf_redact_pdf_redact_post"},"Body_pdf_remove_pages_pdf_remove_pages_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"pages":{"type":"string","title":"Pages","description":"Páginas a excluir, como `2,5-7`"}},"type":"object","required":["file","pages"],"title":"Body_pdf_remove_pages_pdf_remove_pages_post"},"Body_pdf_reorder_pdf_reorder_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"order":{"type":"string","title":"Order","description":"Nova ordem das páginas (a partir de 1), como `3,1,2` ou JSON `[3,1,2]`. Páginas fora da lista são removidas."}},"type":"object","required":["file","order"],"title":"Body_pdf_reorder_pdf_reorder_post"},"Body_pdf_rotate_pdf_rotate_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"angle":{"type":"integer","title":"Angle","description":"90, 180 ou 270 (sentido horário)","default":90},"pages":{"type":"string","title":"Pages","description":"`all` ou páginas como `1,3-5`","default":"all"}},"type":"object","required":["file"],"title":"Body_pdf_rotate_pdf_rotate_post"},"Body_pdf_split_pdf_split_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"mode":{"type":"string","title":"Mode","description":"`all`: uma página por arquivo; `ranges`: por intervalos","default":"all"},"ranges":{"type":"string","title":"Ranges","description":"Com mode=ranges: intervalos como `1-3,5,7-9`","default":""}},"type":"object","required":["file"],"title":"Body_pdf_split_pdf_split_post"},"Body_pdf_unlock_pdf_unlock_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF protegido"},"password":{"type":"string","title":"Password","description":"Senha atual do PDF"}},"type":"object","required":["file","password"],"title":"Body_pdf_unlock_pdf_unlock_post"},"Body_pdf_watermark_pdf_watermark_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"text":{"type":"string","title":"Text","description":"Texto da marca d'água"},"size":{"type":"integer","title":"Size","description":"Tamanho da letra","default":60},"opacity":{"type":"number","title":"Opacity","description":"Opacidade de 0 a 1","default":0.15},"angle":{"type":"integer","title":"Angle","description":"Ângulo (com mode=custom)","default":45},"color":{"type":"string","title":"Color","description":"Cor em hexadecimal","default":"#000000"},"mode":{"type":"string","title":"Mode","description":"`diagonal` (45°), `mosaico` (repetida) ou `custom` (usa `angle`)","default":"diagonal"}},"type":"object","required":["file","text"],"title":"Body_pdf_watermark_pdf_watermark_post"},"Body_run_ocr_ocr_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF escaneado"},"language":{"type":"string","title":"Language","description":"`por`, `eng` ou `por+eng`","default":"por"},"deskew":{"type":"boolean","title":"Deskew","description":"Endireitar páginas tortas","default":true},"force":{"type":"boolean","title":"Force","description":"Refazer o OCR mesmo se o PDF já tiver texto","default":false}},"type":"object","required":["file"],"title":"Body_run_ocr_ocr_post"},"Body_sign_batch_sign_batch_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"PDFs a assinar (até 50)"},"certificate":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Certificate","description":"Certificado A1 (.pfx/.p12)"},"password":{"type":"string","title":"Password","description":"Senha do certificado","default":""},"use_saved_certificate":{"type":"boolean","title":"Use Saved Certificate","description":"Usar o certificado salvo na conta","default":false},"reason":{"type":"string","title":"Reason","default":"Assinatura digital"},"location":{"type":"string","title":"Location","default":""},"contact":{"type":"string","title":"Contact","default":""},"timestamp":{"type":"boolean","title":"Timestamp","default":true},"visible":{"type":"boolean","title":"Visible","default":true},"page":{"type":"integer","title":"Page","description":"Página do carimbo (a partir de 1); 0 = última","default":0},"x":{"type":"number","title":"X","default":3.0},"y":{"type":"number","title":"Y","default":85.0},"width":{"type":"number","title":"Width","default":45.0},"height":{"type":"number","title":"Height","default":10.0},"appearance":{"type":"string","title":"Appearance","default":""},"signature_image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Signature Image"}},"type":"object","required":["files"],"title":"Body_sign_batch_sign_batch_post"},"Body_sign_pdf_sign_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF a assinar"},"certificate":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Certificate","description":"Certificado A1 (.pfx/.p12)"},"password":{"type":"string","title":"Password","description":"Senha do certificado","default":""},"use_saved_certificate":{"type":"boolean","title":"Use Saved Certificate","description":"Usar o certificado salvo na conta","default":false},"reason":{"type":"string","title":"Reason","description":"Motivo","default":"Assinatura digital"},"location":{"type":"string","title":"Location","description":"Local (ex.: Porto Alegre/RS)","default":""},"contact":{"type":"string","title":"Contact","description":"Contato","default":""},"timestamp":{"type":"boolean","title":"Timestamp","description":"Carimbo do tempo (TSA)","default":true},"visible":{"type":"boolean","title":"Visible","description":"Carimbo visível na página","default":true},"page":{"type":"integer","title":"Page","description":"Página do carimbo (a partir de 1); 0 = última","default":0},"x":{"type":"number","title":"X","description":"Posição horizontal do carimbo (% da página)","default":3.0},"y":{"type":"number","title":"Y","description":"Posição vertical (% da página)","default":85.0},"width":{"type":"number","title":"Width","description":"Largura (% da página)","default":45.0},"height":{"type":"number","title":"Height","description":"Altura (% da página)","default":10.0},"appearance":{"type":"string","title":"Appearance","description":"JSON de aparência (opcional)","default":""},"signature_image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Signature Image","description":"Rubrica em PNG (opcional)"},"pdf_password":{"type":"string","title":"Pdf Password","description":"Senha do PDF, se ele for protegido","default":""}},"type":"object","required":["file"],"title":"Body_sign_pdf_sign_post"},"Body_signatures_inspect_signatures_inspect_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF assinado"},"password":{"type":"string","title":"Password","description":"Senha do PDF, se protegido","default":""}},"type":"object","required":["file"],"title":"Body_signatures_inspect_signatures_inspect_post"},"Body_translate_start_translate_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF"},"source":{"type":"string","title":"Source","description":"Idioma de origem (`auto` detecta)","default":"auto"},"target":{"type":"string","title":"Target","description":"Idioma de destino, ex.: `pt`, `en`, `es`","default":"pt"}},"type":"object","required":["file"],"title":"Body_translate_start_translate_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ChaveAPI":{"type":"http","description":"Chave da API: `Authorization: Bearer epdf_live_…`","scheme":"bearer"},"XApiKey":{"type":"apiKey","description":"Alternativa: a mesma chave no cabeçalho `X-API-Key`.","in":"header","name":"X-API-Key"}}},"tags":[{"name":"Conta","description":"Dados da chave, da organização e uso da API."},{"name":"PDF","description":"Juntar, dividir, comprimir, girar, proteger, marca d'água, numerar, censurar…"},{"name":"Conversão","description":"PDF ↔ Word, imagens, Office e PDF/A."},{"name":"OCR","description":"Torna PDFs escaneados pesquisáveis (português e inglês)."},{"name":"Assinatura digital","description":"Assinatura PAdES com certificado ICP-Brasil A1 e verificação de assinaturas de um PDF."},{"name":"Tradução","description":"Tradução de PDF mantendo o layout (tarefa assíncrona)."},{"name":"Tarefas","description":"Acompanhamento e resultado de tarefas assíncronas."},{"name":"Verificação","description":"Consulta pública dos registros de assinatura (QR Code)."}]}