Renamed.to REST API v1

Transforme uploads desorganizados em nomes de arquivos consistentes e legíveis com uma única chamada de API. A Renamed.to lê o próprio arquivo (OCR para digitalizações, NLP para texto) para extrair os campos corretos, depois aplica seu modelo de nomenclatura para retornar exatamente o nome de arquivo que você espera—todas as vezes. JSON limpo de entrada/saída com autenticação Bearer token, para que você possa integrar em minutos.

Renomeie arquivos a partir de seu conteúdo, não de seus nomes existentes.

Lê o arquivo (OCR para digitalizações) para extrair metadados reais
Modelos que você controla: automático, pré-definidos ou personalizados em linguagem natural
Saída consistente e segura com caracteres que funcionam em todos os lugares
REST API JSON com autenticação Bearer token
Caminho de pasta opcional para roteamento inteligente e organização
Padrões que priorizam privacidade e evitam armazenamento de conteúdo a longo prazo

Comece agora: 50 créditos gratuitos for new accounts.

URL Base

https://www.renamed.to/api/v1

Início Rápido: Gere um token de API em Configurações → Tokens de API, depois faça sua primeira requisição usando os exemplos abaixo.

Primeiros Passos

Comece a usar a REST API da Renamed.to em minutos. Siga estes passos para fazer sua primeira chamada de API e começar a renomear arquivos PDF programaticamente.

Crie uma Conta

Cadastre-se gratuitamente em renamed.to/sign-up. Novas contas recebem 50 créditos gratuitos para começar.

Gere um Token de API

Navegue até Configurações → Tokens de APIe crie um novo token de API. Tokens são mostrados apenas uma vez quando criados—certifique-se de salvá-lo com segurança.

Dica: Use nomes descritivos para seus tokens (por exemplo, "Servidor de Produção", "Desenvolvimento") para ajudar a gerenciar múltiplos tokens.

Faça sua Primeira Requisição

Use seu token de API para autenticar requisições. O serviço extrairá automaticamente os metadados de seus arquivos PDF. Aqui está um exemplo mínimo:

Nota: Estes são exemplos simplificados para começar. Para código de produção com tratamento abrangente de erros, lógica de retry e validação, consulte Tratamento de Erros

curl -X POST https://www.renamed.to/api/v1/rename \
  -H "Authorization: Bearer rt_your_token_here" \
  -F file=@invoice.pdf

Processe a Resposta

Uma resposta bem-sucedida inclui o nome de arquivo gerado e o caminho da pasta com metadados extraídos:

Problemas Comuns

Erro 415 no Python: Se estiver usando Python, certifique-se de que os uploads de arquivo incluam nome de arquivo e tipo de conteúdo (veja Requisitos de Upload de Arquivo Python)
Erros 401: Verifique se seu token de API está correto e tem as permissões necessárias
Tamanho do Arquivo: O tamanho máximo do arquivo é 25 MB para arquivos PDF e imagens digitalizadas (JPG, PNG, TIFF)

Próximos Passos

Precisa de ajuda? Confira nossa documentação or contact support if you run into any issues.

Versionamento da API

A API da Renamed.to usa versionamento baseado em URL para garantir estabilidade e compatibilidade retroativa conforme evoluímos a plataforma.

Versão Atual

A versão atual da API é v1, acessível em:

https://www.renamed.to/api/v1

Política de Versionamento

Compatibilidade Retroativa

Mantemos compatibilidade retroativa dentro de cada versão principal. Novos recursos e mudanças não destrutivas são adicionados à versão atual sem exigir alterações de código em sua integração.

Mudanças Destrutivas

Mudanças destrutivas (endpoints removidos, formatos de resposta alterados, campos removidos) resultarão em uma nova versão principal (por exemplo, v2). Quando uma nova versão principal for lançada:

A versão anterior permanece disponível por pelo menos 12 meses
Fornecemos guias de migração e avisos de descontinuação
Mudanças destrutivas são anunciadas com pelo menos 90 dias de antecedência

Cronograma de Descontinuação

Quando uma versão é descontinuada, seguimos este cronograma:

Aviso de 90 dias: Anúncio de descontinuação com guia de migração
Suporte de 12 meses: Versão descontinuada permanece funcional
Desativação: Versão descontinuada é desativada após o período de suporte

Solicitando uma Versão Específica

A versão da API é especificada no caminho da URL. Sempre inclua o número da versão em suas requisições:

https://www.renamed.to/api/v1/rename✓ Versão atual

https://www.renamed.to/api/v2/renameVersão futura (ainda não disponível)

Headers de Versão

Embora o versionamento seja tratado via caminho da URL, as respostas da API incluem informações de versão nos headers:

Header	Descrição	Exemplo
`API-Version`	A versão da API usada para a requisição	v1

Mantendo-se Atualizado

Para se manter informado sobre mudanças na API e atualizações de versão:

Confira o Changelog
Assine nosso feed RSS de changelog da API (em breve)
Monitore o header API-Version nas respostas
Acompanhe nossa página de status para disponibilidade da API e incidentes

Note: Nota: A API v1 é estável e ativamente mantida. Não temos planos de descontinuar a v1 em um futuro próximo. Quando a v2 for lançada, ambas as versões serão suportadas simultaneamente.

Autenticação

Cada requisição deve ser autenticada usando um Bearer token. Tokens de API são chaves de API de longa duração que fornecem acesso completo à sua conta.

Formato do Token

Tokens de API são prefixados com rt_ seguido de 64 caracteres hexadecimais. Exemplo: rt_abc123def456...

Obtendo seu Token

Gere tokens de API na seção Tokens de API de suas configurações. Tokens são mostrados apenas uma vez quando criados—certifique-se de salvá-los com segurança.

Usando seu Token

Inclua seu token no header Authorization com o prefixo Bearer:

curl -X GET https://www.renamed.to/api/v1/user \
  -H "Authorization: Bearer rt_your_token_here"

Permissões do Token

Tokens de API fornecem acesso a todos os endpoints da API, incluindo renomeação de arquivos, informações de perfil do usuário, saldo de créditos e informações da equipe.

Respostas de Erro

Se a autenticação falhar, você receberá uma resposta 401 Unauthorized:

Segurança do Token

Armazene tokens com segurança—nunca os envie para controle de versão ou os exponha em código do lado do cliente
Use variáveis de ambiente ou sistemas de gerenciamento de segredos seguros
Rotacione tokens regularmente criando novos tokens e excluindo os antigos em Configurações → Tokens de API
Se um token for comprometido, exclua-o imediatamente de suas configurações

Endpoints da API

Endpoints Rename

Renomeie arquivos PDF e imagens digitalizadas usando metadados extraídos por IA.

Endpoints PDF Split

Divida PDFs de múltiplas páginas em documentos individuais com nomenclatura automática.

Conta & Recursos

Gerencie perfis de usuário, verifique saldos de créditos e associação de equipe.

Referência & Solução de Problemas

Códigos de erro, limites de taxa, guias de solução de problemas e FAQ.