Localizar e substituir texto - Editor de conteúdo API
PDF4me Localizar e substituir texto permite encontrar e substituir padrões de texto específicos em PDF documentos. Isto API processos de serviço PDF arquiva e pesquisa textos para substituir por novo conteúdo em páginas específicas. O API recebe PDF parâmetros de conteúdo e substituição por meio de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para direcionamento flexível de páginas e correspondência de padrões de texto, esta solução é ideal para atualizações de documentos e fluxos de trabalho de gerenciamento de conteúdo.
Autenticando seu API Solicitar
Para acessar o PDF4me REST APIPara que uma solicitação seja aceita, é necessário incluir as credenciais de autenticação adequadas. A autenticação garante a segurança da comunicação e valida sua identidade como usuário autorizado do sistema. REST API.
Principais características
- Correspondência de padrões de textoEncontre e substitua padrões de texto específicos em PDF documentos
- Segmentação flexível de páginasProcessar páginas específicas ou documentos inteiros com sequências de páginas personalizadas.
- Suporte à sequência de páginasSelecione páginas individuais, intervalos de páginas ou seleções mistas de páginas.
- Base64 CodificaçãoTransmissão segura de conteúdo de arquivos usando Base64 codificação
- Simple API IntegraçãoRESTful API projetado para automatizado PDF fluxos de trabalho de edição de texto
REST API Ponto final
O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de localização e substituição de texto são realizadas por meio de um único ponto de extremidade:
- Método: POST
- Ponto final:
/api/v2/FindAndReplace
REST API Parâmetros
Lista completa de parâmetros para a função Localizar e Substituir Texto. REST APIOs parâmetros estão organizados por categoria para melhor compreensão e implementação.
Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios e devem ser fornecidos para o API para funcionar corretamente.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| docContent* | Base64 | O conteúdo da entrada PDF arquivo codificado em Base64 | JVBERi... |
| docName* | String | Fonte PDF nome do arquivo com extensão .pdf | output.pdf |
| oldText* | String | Texto a ser pesquisado e substituído | This is some |
| newText* | String | Texto a ser substituído por | Here is few |
| pageSequence* | String | Opções de página: "1" para página 1, "1,3,5" para páginas específicas, "2-5" para intervalo de páginas, "1,3,7-10" para páginas mistas, "1-" para páginas de 1 até o final. | 1 |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| async | Boolean | Ative o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no cabeçalho de localização | true |
Saída
O PDF4me Localizar e substituir texto REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o PDF como dados binários para processamento síncrono ou fornece uma sondagem URL para processamento assíncrono.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Processamento síncrono (padrão)
Quando async não está definido ou está definido como false, o API processa a solicitação imediatamente:
Código de status: 200 OK
Tipo de conteúdo: application/pdf ou application/octet-stream
Corpo da resposta:
O API retorna o PDF arquivo diretamente como dados binários (não JSON).
Como usar:
- O corpo da resposta contém o binário PDF dados
- Salve o conteúdo da resposta diretamente como um PDF arquivo
- Não Base64 A decodificação é necessária para respostas binárias.
Exemplo (JavaScript):
const response = await fetch(url, options);
const pdfBlob = await response.blob();
// Save or process pdfBlob directly
Processamento assíncrono
Quando async: true está definido, o API processa a solicitação de forma assíncrona:
Código de status: 202 Accepted
Cabeçalhos de resposta:
Location: https://api.pdf4me.com/api/v2/FindAndReplace/poll/12345-abcde-67890
Processo de votação:
- Extraia o
Locationcabeçalho da resposta 202 - Faça a pesquisa URL usando GET solicitações
- Continue votando até receber um 200 OK status
- A resposta final contém o binário PDF dados
Exemplo de votação:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const pdfBlob = await pollResponse.blob();
// Process binary PDF
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Respostas de erro
| Código de status | Descrição | Exemplo de resposta |
|---|---|---|
| 400 Bad Request | Parâmetros de solicitação inválidos ou campos obrigatórios ausentes | {"error": "Missing required parameter: oldText"} |
| 401 Unauthorized | Inválido ou ausente API chave | {"error": "Unauthorized"} |
| 500 Internal Server Error | Erro do servidor durante o processamento | {"error": "Internal server error"} |
Entendendo a Resposta
- Síncrono (200): Retorna binário PDF dados diretamente
- Assíncrono (202)Retorna o cabeçalho Location para sondagem; a resposta final é binária. PDF
- Não JSON Invólucro: O API retornos PDF como binário, não encapsulado em JSON com Base64 codificação
Exemplo de solicitação
Cabeçalho
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Observação: O API a chave deve ser Base64 codificado. Obtenha o seu API chave do PDF4me Painel
Carga útil
{
"docContent": "JVBERi...",
"docName": "output.pdf",
"oldText": "input_old_text",
"newText": "output_new_text",
"pageSequence": "1"
}
Exemplos de código
O PDF4me Localizar e substituir texto REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Exemplo
Completo C# implementação para encontrar e substituir texto em PDF:
Java Amostra
Java Implementação com tratamento completo de erros e processamento de respostas:
JavaScript Amostra
Node.js e compatível com navegadores JavaScript Implementação:
Google Apps Script Amostra
Google Apps Script implementação para Google Workspace integração:
Recursos de substituição de texto
Processamento de padrões de texto
- Correspondência exataCorrespondência de padrões de texto que diferencia maiúsculas de minúsculas para identificação precisa.
- Reconhecimento de padrõesSuporte para palavras, frases e padrões de texto específicos.
- Padrões personalizadosCriação flexível de padrões para requisitos específicos de substituição de texto.
- Resultados profissionaisSubstituição de texto confiável com correspondência de padrões precisa.
- Processamento AvançadoSuporte para estruturas de texto e formatação complexas.
Processamento de página
- Segmentação de páginaSubstituir texto em páginas específicas ou em documentos inteiros.
- Sequências de páginasSuporte para intervalos de páginas personalizados e seleção de páginas individuais.
- Processamento flexívelProcessar qualquer combinação de páginas com controle preciso
- Processamento em loteGerencie várias páginas de forma eficiente em uma única tela. API ligações
- Layout profissionalSubstituição consistente de texto em todas as páginas de destino.
Recursos avançados
- Análise de textoAnálise e identificação abrangentes de padrões textuais
- Gestão de ConteúdoOpções avançadas de edição de conteúdo e substituição de texto:
- Edição profissionalSubstituição de texto de alta qualidade com visibilidade clara.
- Padrões flexíveisSuporte para qualquer padrão de texto e requisitos de substituição.
Casos de uso e aplicações industriais
- Business & Enterprise
- Legal & Professional Services
- Finance & Banking
- Government & Compliance
Casos de uso para empresas e negócios
- Atualizações de documentosAtualizar automaticamente o conteúdo do texto em várias instâncias. PDF documentos
- Gestão de ConteúdoSubstitua as informações desatualizadas por dados atuais em PDF arquivos
- Processamento de modelosAtualizar o texto de exemplo com o conteúdo real nos modelos de documento
- Gestão de MarcaAtualizar nomes de empresas, logotipos e elementos de marca em todas as plataformas. PDFs
Casos de uso de serviços jurídicos e profissionais
- Edição de Documentos LegaisSubstituir termos e cláusulas específicos em documentos legais. PDF documentos
- Atualizações de contratoAtualizar os termos e cláusulas contratuais em todos os documentos legais.
- Atualizações de conformidadeSubstituir informações regulatórias e dados de conformidade em documentos.
- Padronização de Documentos LegaisPadronizar a terminologia jurídica em todos os documentos.
Casos de uso em finanças e bancos
- Geração de relatóriosAtualizar métricas, datas e pontos de dados nos dados gerados. PDF relatórios
- Atualizações de documentos financeirosAtualizar informações financeiras em PDF documentos
- Atualizações de conformidadeSubstituir informações regulatórias em documentos financeiros.
- Padronização de Relatórios FinanceirosPadronizar a terminologia financeira em todos os relatórios.
Casos de uso para governo e conformidade
- Atualizações de conformidadeSubstituir informações regulatórias e dados de conformidade em documentos.
- Documentação regulamentarAtualizar informações regulatórias em documentos governamentais.
- Padronização de DocumentosPadronizar a terminologia e a formatação em todas as coleções de documentos.
- Registros PúblicosAtualizar informações em registros públicos e documentos governamentais.