Renamed.to logorenamed.to
Volver a renamed.to
Documentación
Documentación/REST API

Renamed.to REST API v1

Convierta cargas desordenadas en nombres de archivo consistentes y legibles con una sola llamada API. Renamed.to lee el archivo mismo (OCR para escaneos, NLP para texto) para extraer los campos correctos, luego aplica su plantilla de nombres para devolver el nombre de archivo exacto que usted espera—siempre. JSON limpio de entrada/salida con autenticación Bearer token, para que pueda integrar en minutos.

Renombre archivos a partir de su contenido, no de sus nombres existentes.

  • Lee el archivo (OCR para escaneos) para extraer metadatos reales
  • Plantillas que usted controla: automáticas, prediseñadas o personalizadas en lenguaje natural
  • Salida consistente y segura con caracteres que funcionan en todas partes
  • REST API basada en JSON con autenticación Bearer token
  • Ruta de carpeta opcional para enrutamiento inteligente y organización
  • Valores predeterminados que priorizan la privacidad y evitan el almacenamiento de contenido a largo plazo

Comenzar: 50 créditos gratis for new accounts.

URL Base

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

Inicio Rápido: Genere un token API en Configuración → Tokens API, luego realice su primera solicitud usando los ejemplos a continuación.

Comenzando

Póngase en marcha con la REST API de Renamed.to en minutos. Siga estos pasos para realizar su primera llamada API y comenzar a renombrar archivos PDF programáticamente.

1

Crear una Cuenta

Regístrese para obtener una cuenta gratuita en renamed.to/sign-up. Las nuevas cuentas reciben 50 créditos gratis para comenzar.

2

Generar un Token API

Navegue a Configuración → Tokens APIy cree un nuevo token API. Los tokens se muestran solo una vez cuando se crean—asegúrese de guardarlo de forma segura.

Consejo: Use nombres descriptivos para sus tokens (por ejemplo, "Servidor de Producción", "Desarrollo") para ayudar a administrar múltiples tokens.

3

Realizar su Primera Solicitud

Use su token API para autenticar solicitudes. El servicio extraerá automáticamente metadatos de sus archivos PDF. Aquí hay un ejemplo mínimo:

Nota: Estos son ejemplos simplificados para comenzar. Para código de producción con manejo integral de errores, lógica de reintentos y validación, consulte Manejo de Errores

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

Manejar la Respuesta

Una respuesta exitosa incluye el nombre de archivo generado y la ruta de carpeta con metadatos extraídos:

Problemas Comunes

  • Error 415 en Python: Si usa Python, asegúrese de que las cargas de archivos incluyan filename y content-type (consulte Requisitos de Carga de Archivos en Python)
  • Errores 401: Verifique que su token API sea correcto y tenga los permisos necesarios
  • Tamaño de Archivo: El tamaño máximo de archivo es de 25 MB para archivos PDF e imágenes escaneadas (JPG, PNG, TIFF)

Próximos Pasos

¿Necesita ayuda? Consulte nuestra documentación or contact support if you run into any issues.

Versionado de API

La API de Renamed.to usa versionado basado en URL para garantizar estabilidad y compatibilidad hacia atrás a medida que evolucionamos la plataforma.

Versión Actual

La versión actual de la API es v1, accesible en:

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

Política de Versionado

Compatibilidad hacia Atrás

Mantenemos la compatibilidad hacia atrás dentro de cada versión mayor. Las nuevas características y cambios que no rompen compatibilidad se agregan a la versión actual sin requerir cambios de código en su integración.

Cambios que Rompen Compatibilidad

Los cambios que rompen compatibilidad (endpoints eliminados, formatos de respuesta modificados, campos eliminados) resultarán en una nueva versión mayor (por ejemplo, v2). Cuando se lance una nueva versión mayor:

  • La versión anterior permanece disponible por al menos 12 meses
  • Proporcionamos guías de migración y avisos de deprecación
  • Los cambios que rompen compatibilidad se anuncian con al menos 90 días de anticipación

Cronograma de Deprecación

Cuando una versión queda obsoleta, seguimos este cronograma:

  • Aviso de 90 días: Anuncio de deprecación con guía de migración
  • Soporte de 12 meses: La versión obsoleta permanece funcional
  • Finalización: La versión obsoleta se retira después del período de soporte

Solicitar una Versión Específica

La versión de API se especifica en la ruta URL. Incluya siempre el número de versión en sus solicitudes:

https://www.renamed.to/api/v1/rename✓ Versión actual
https://www.renamed.to/api/v2/renameVersión futura (aún no disponible)

Encabezados de Versión

Aunque el versionado se maneja a través de la ruta URL, las respuestas de API incluyen información de versión en los encabezados:

EncabezadoDescripciónEjemplo
API-VersionLa versión de API usada para la solicitudv1

Mantenerse Actualizado

Para mantenerse informado sobre cambios de API y actualizaciones de versión:

  • Consulte el Registro de Cambios
  • Suscríbase a nuestro feed RSS de registro de cambios de API (próximamente)
  • Monitoree el encabezado API-Version en las respuestas
  • Siga nuestra página de estado para disponibilidad de API e incidentes

Note: Nota: La API v1 es estable y se mantiene activamente. No tenemos planes de deprecar v1 en el futuro cercano. Cuando se lance v2, ambas versiones se soportarán simultáneamente.

Autenticación

Cada solicitud debe estar autenticada usando un Bearer token. Los tokens API son claves API de larga duración que proporcionan acceso completo a su cuenta.

Formato de Token

Los tokens API tienen el prefijo rt_ seguido de 64 caracteres hexadecimales. Ejemplo: rt_abc123def456...

Obtener su Token

Genere tokens API en la sección Tokens API de su configuración. Los tokens se muestran solo una vez cuando se crean—asegúrese de guardarlos de forma segura.

Usar su Token

Incluya su token en el encabezado Authorization con el prefijo Bearer:

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

Permisos de Token

Los tokens API proporcionan acceso a todos los endpoints de API, incluyendo renombrado de archivos, información de perfil de usuario, saldo de créditos e información de equipo.

Respuestas de Error

Si la autenticación falla, recibirá una respuesta 401 Unauthorized:

Seguridad del Token

  • Almacene los tokens de forma segura—nunca los confirme en control de versiones ni los exponga en código del lado del cliente
  • Use variables de entorno o sistemas seguros de gestión de secretos
  • Rote los tokens regularmente creando nuevos tokens y eliminando los antiguos desde Configuración → Tokens API
  • Si un token está comprometido, elimínelo inmediatamente desde su configuración

Endpoints de API

Endpoints de Renombrado

Renombre archivos PDF e imágenes escaneadas usando metadatos extraídos con IA.

Endpoints de División de PDF

Divida PDFs de múltiples páginas en documentos individuales con nombrado automático.

Cuenta y Recursos

Administre perfiles de usuario, consulte saldos de créditos y membresía de equipo.

Referencia y Solución de Problemas

Códigos de error, límites de tasa, guías de solución de problemas y preguntas frecuentes.