ForHosting KIT · Strumenti per sviluppatori

Cercare estensioni di file dal tipo MIME

Converta un tipo di contenuto MIME nelle estensioni di file normalmente riconosciute dagli utenti e dal software.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

La ricerca accetta valori come application/json, image/jpeg o text/html; charset=utf-8, normalizza maiuscole e minuscole, elimina i parametri MIME e restituisce sia l’estensione preferita sia tutte le alternative comuni presenti nella tabella integrata. È utile quando un’intestazione di risposta, un record di caricamento o un URI di dati indica il tipo di supporto, ma non fornisce un nome file affidabile.

Converta un tipo di contenuto in un suffisso pratico

Le risposte HTTP, gli allegati e-mail, gli archivi di oggetti e gli URI di dati spesso identificano un contenuto tramite il tipo MIME, lasciando però vuoto o inaffidabile il nome del file. Questa ricerca fornisce alla Sua applicazione un suffisso pratico. Invii un valore nel consueto formato tipo/sottotipo, come image/jpeg, e riceverà un’estensione principale con un elenco ordinato di alternative riconosciute. Il valore principale è la scelta convenzionale per creare un nome, mentre l’elenco completo consente di confrontare un nome esistente o mostrare le forme accettate. Le estensioni vengono restituite senza punto iniziale, così Lei può unirle, confrontarle o formattarle secondo le proprie regole. Il servizio non esamina i byte e non sostiene che un’intestazione dimostri l’autenticità del file. Esegue soltanto l’operazione inversa rispetto alla mappatura da estensione a MIME usando una tabella integrata di formati web, documenti, archivi, font, audio, immagini e video.

Comprenda normalizzazione, alias ed estensioni multiple

I valori reali del tipo di contenuto raramente sono ordinati come gli esempi di un registro. I server possono usare lettere maiuscole o aggiungere parametri, per esempio la codifica. La ricerca elimina gli spazi esterni, converte il tipo di supporto in minuscolo e ignora tutto ciò che segue il primo punto e virgola. Di conseguenza, Text/HTML; charset=UTF-8 viene risolto come text/html. Prima di consultare la tabella viene verificata la sintassi normalizzata tipo/sottotipo, distinguendo così un valore malformato da un tipo MIME valido ma non supportato. Alcuni formati hanno più suffissi comuni: per image/jpeg, il risultato preferito è jpg e le alternative includono jpeg e jpe. L’ordine è intenzionale e stabile, quindi Lei può usare primary_extension senza definire regole proprie. Sono accettati anche gli alias content_type e mime, sebbene mime_type sia il campo canonico mostrato nei client generati.

Usi il risultato in sicurezza nei flussi di importazione e download

Un flusso comune riceve un corpo e un’intestazione Content-Type, sceglie un’estensione e archivia il corpo con un nome generato. Usi primary_extension per l’ultimo componente, ma mantenga separata la convalida del contenuto. I metadati MIME possono mancare, essere errati o essere controllati da chi carica il file; aggiungere un suffisso plausibile non rende sicuri byte non attendibili. Se il Suo sistema esegue, visualizza in anteprima o pubblica il risultato, esamini prima il contenuto e applichi la politica di sicurezza pertinente. L’elenco completo è utile per la convalida: normalizzi il suffisso di un nome esistente e verifichi se compare tra le alternative, anziché rifiutare un jpeg legittimo perché il valore preferito è jpg. I tipi sconosciuti generano un errore esplicito, poiché dedurre un nome dal sottotipo può essere fuorviante o pericoloso. La tabella è inclusa e la stessa voce produce sempre la stessa uscita. L’esecuzione API costa $0.002 per elemento.

Assegnare un nome a una risposta scaricata

Scelga un suffisso convenzionale quando una risposta HTTP include Content-Type ma non un nome Content-Disposition utilizzabile.

Controllare i metadati di caricamento

Confronti il suffisso del file caricato con tutte le estensioni comuni associate al tipo MIME dichiarato.

Esportare oggetti binari archiviati

Ricostruisca nomi leggibili dai metadati che conservano il tipo MIME, ma non il nome originale.

L’estensione restituita include il punto?

No. Le estensioni sono restituite come jpg o html, senza punto iniziale.

Che cosa accade a charset e agli altri parametri MIME?

I parametri successivi al primo punto e virgola vengono ignorati; text/html; charset=utf-8 viene quindi cercato come text/html.

Perché un tipo MIME può restituire più estensioni?

Alcuni formati hanno più suffissi consolidati. Il risultato ne indica uno preferito e mantiene le alternative comuni in ordine stabile.

Questa funzione verifica il contenuto del file?

No. Associa soltanto i metadati MIME dichiarati. Esamini separatamente i byte non attendibili prima di eseguirli, visualizzarli o pubblicarli.

Che cosa accade se il tipo MIME non è nella tabella?

La ricerca restituisce un errore di input non valido invece di dedurre un’estensione dal sottotipo.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/dev/extension-from-mime

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/dev/extension-from-mime \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mime_type":"application/json; charset=utf-8"}'
{
  "mime_type": "application/json; charset=utf-8"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.extension_from_mime",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →