Renamed.to REST API v1

Trasformi caricamenti disordinati in nomi file coerenti e leggibili con una singola chiamata API. Renamed.to legge il file stesso (OCR per scansioni, NLP per testo) per estrarre i campi corretti, quindi applica il Suo modello di denominazione per restituire il nome file esatto che si aspetta—ogni volta. JSON pulito in entrata/uscita con autenticazione Bearer token, così può integrare in pochi minuti.

Rinomini file dal loro contenuto, non dai loro nomi esistenti.

Legge il file (OCR per scansioni) per estrarre metadati reali
Modelli che Lei controlla: automatico, predefiniti o personalizzati in linguaggio naturale
Output coerente e sicuro con caratteri che funzionano ovunque
REST API basata su JSON con autenticazione Bearer token
Percorso cartella opzionale per routing intelligente e organizzazione
Impostazioni predefinite privacy-first che evitano l'archiviazione a lungo termine dei contenuti

Per iniziare: 50 crediti gratuiti for new accounts.

Base URL

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

Avvio Rapido: Generi un token API in Impostazioni → Token API, quindi effettui la Sua prima richiesta usando gli esempi qui sotto.

Primi Passi

Avvii e usi la REST API di Renamed.to in pochi minuti. Segua questi passaggi per effettuare la Sua prima chiamata API e iniziare a rinominare file PDF in modo programmatico.

Crei un Account

Si registri per un account gratuito su renamed.to/sign-up. I nuovi account ricevono 50 crediti gratuiti per iniziare.

Generi un Token API

Navighi su Impostazioni → Token APIe crei un nuovo token API. I token vengono mostrati solo una volta al momento della creazione—si assicuri di salvarlo in modo sicuro.

Suggerimento: Usi nomi descrittivi per i Suoi token (ad es., "Server Produzione", "Sviluppo") per aiutare a gestire più token.

Effettui la Sua Prima Richiesta

Usi il Suo token API per autenticare le richieste. Il servizio estrarrà automaticamente metadati dai Suoi file PDF. Ecco un esempio minimale:

Nota: Questi sono esempi semplificati per iniziare. Per codice di produzione con gestione completa degli errori, logica di retry e validazione, veda la sezione Gestione Errori

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

Gestisca la Risposta

Una risposta riuscita include il nome file generato e il percorso della cartella con i metadati estratti:

Problemi Comuni

Errore 415 Python: Se usa Python, si assicuri che i caricamenti file includano filename e content-type (veda Requisiti Caricamento File Python)
Errori 401: Verifichi che il Suo token API sia corretto e abbia i permessi necessari
Dimensione File: La dimensione massima del file è 25 MB per file PDF e immagini scansionate (JPG, PNG, TIFF)

Prossimi Passi

Legga la sezione Autenticazione
Esplori l'endpoint Rename
Riveda la Gestione Errori
Consulti gli Esempi di Casi d'Uso
Veda la sezione Risoluzione Problemi

Serve aiuto? Consulti la nostra documentazione or contact support if you run into any issues.

Versionamento API

L'API di Renamed.to usa il versionamento basato su URL per garantire stabilità e compatibilità retroattiva mentre evolviamo la piattaforma.

Versione Corrente

La versione corrente dell'API è v1, accessibile su:

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

Politica di Versionamento

Compatibilità Retroattiva

Manteniamo la compatibilità retroattiva all'interno di ogni versione principale. Nuove funzionalità e modifiche non distruttive vengono aggiunte alla versione corrente senza richiedere modifiche al codice nella Sua integrazione.

Modifiche Distruttive

Le modifiche distruttive (endpoint rimossi, formati di risposta modificati, campi rimossi) risulteranno in una nuova versione principale (ad es., v2). Quando viene rilasciata una nuova versione principale:

La versione precedente rimane disponibile per almeno 12 mesi
Forniamo guide di migrazione e avvisi di deprecazione
Le modifiche distruttive vengono annunciate con almeno 90 giorni di anticipo

Timeline di Deprecazione

Quando una versione viene deprecata, seguiamo questa timeline:

90 giorni di preavviso: Annuncio di deprecazione con guida di migrazione
12 mesi di supporto: La versione deprecata rimane funzionale
Ritiro: La versione deprecata viene ritirata dopo il periodo di supporto

Richiedere una Versione Specifica

La versione dell'API è specificata nel percorso URL. Includa sempre il numero di versione nelle Sue richieste:

https://www.renamed.to/api/v1/rename✓ Versione corrente

https://www.renamed.to/api/v2/renameVersione futura (non ancora disponibile)

Header di Versione

Mentre il versionamento è gestito tramite percorso URL, le risposte API includono informazioni sulla versione negli header:

Header	Descrizione	Esempio
`API-Version`	La versione API usata per la richiesta	v1

Rimanere Aggiornati

Per rimanere informato sulle modifiche all'API e aggiornamenti di versione:

Consulti il Changelog
Si iscriva al nostro feed RSS changelog API (in arrivo)
Monitori l'header API-Version nelle risposte
Segua la nostra pagina di stato per disponibilità API e incidenti

Note: Nota: L'API v1 è stabile e attivamente mantenuta. Non abbiamo piani per deprecare v1 nel prossimo futuro. Quando v2 verrà rilasciata, entrambe le versioni saranno supportate simultaneamente.

Autenticazione

Ogni richiesta deve essere autenticata usando un Bearer token. I token API sono chiavi API a lunga durata che forniscono accesso completo al Suo account.

Formato Token

I token API sono prefissati con rt_ seguiti da 64 caratteri esadecimali. Esempio: rt_abc123def456...

Ottenere il Suo Token

Generi token API nella sezione Token API delle Sue impostazioni. I token vengono mostrati solo una volta al momento della creazione—si assicuri di salvarli in modo sicuro.

Usare il Suo Token

Includa il Suo token nell'header Authorization con il prefisso Bearer:

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

Permessi Token

I token API forniscono accesso a tutti gli endpoint API, inclusi rinominazione file, informazioni profilo utente, saldo crediti e informazioni team.

Risposte di Errore

Se l'autenticazione fallisce, riceverà una risposta 401 Unauthorized:

Sicurezza Token

Memorizzi i token in modo sicuro—non li committi mai nel controllo di versione né li esponga nel codice client-side
Usi variabili di ambiente o sistemi di gestione segreti sicuri
Ruoti i token regolarmente creando nuovi token ed eliminando quelli vecchi da Impostazioni → Token API
Se un token viene compromesso, lo elimini immediatamente dalle Sue impostazioni

Endpoint API

Endpoint Rename

Rinomini file PDF e immagini scansionate usando metadati estratti con AI.

Endpoint PDF Split

Divida PDF multi-pagina in documenti individuali con denominazione automatica.

Account & Risorse

Gestisca profili utente, verifichi saldi crediti e appartenenza al team.

Riferimento & Risoluzione Problemi

Codici errore, limiti di velocità, guide di risoluzione problemi e FAQ.