Buscar extensiones de archivo por tipo MIME

La consulta admite valores como application/json, image/jpeg o text/html; charset=utf-8, normaliza mayúsculas y minúsculas, elimina los parámetros MIME y devuelve tanto una extensión preferida como todas las alternativas habituales de su tabla integrada. Resulta útil cuando una cabecera de respuesta, un registro de carga o una URI de datos indica el tipo multimedia, pero no ofrece un nombre de archivo fiable.

Convierta un tipo de contenido en un sufijo de archivo práctico

Las respuestas HTTP, los adjuntos de correo, los almacenes de objetos y las URI de datos suelen identificar una carga mediante un tipo MIME, aunque dejen el nombre del archivo vacío o no sea fiable. Esta consulta proporciona a su aplicación un sufijo práctico. Envíe un valor con el formato habitual tipo/subtipo, como image/jpeg, y recibirá una extensión principal junto con una lista ordenada de alternativas reconocidas. El valor principal es la opción convencional para crear un nombre; la lista completa sirve para comparar uno existente o mostrar formatos admitidos. Las extensiones se devuelven sin punto inicial para que usted pueda unirlas, compararlas o darles el formato que necesite. El servicio no inspecciona los bytes ni afirma que una cabecera demuestre la autenticidad del archivo. Solo invierte una asociación de extensión a MIME mediante una tabla integrada de formatos web, documentos, archivos comprimidos, fuentes, audio, imágenes y vídeo.

Comprenda la normalización, los alias y las extensiones múltiples

Los valores reales de tipo de contenido rara vez son tan limpios como los ejemplos de un registro. Los servidores pueden usar mayúsculas o añadir parámetros como la codificación. La consulta recorta espacios, convierte el tipo multimedia a minúsculas e ignora lo situado tras el primer punto y coma. Por ello, Text/HTML; charset=UTF-8 se resuelve igual que text/html. Antes de consultar la tabla, valida la sintaxis tipo/subtipo normalizada, lo que distingue una entrada mal formada de un tipo MIME válido pero no compatible. Algunos formatos poseen varios sufijos conocidos: para image/jpeg, el resultado preferido es jpg y las alternativas incluyen jpeg y jpe. El orden es deliberado y estable, de modo que usted puede usar primary_extension sin crear reglas propias. También se aceptan los alias content_type y mime, aunque mime_type es el campo canónico de los clientes generados.

Use el resultado de forma segura en cargas y descargas

Un flujo habitual recibe un cuerpo y una cabecera Content-Type, elige una extensión y almacena el cuerpo con un nombre generado. Use primary_extension para el último componente, pero valide el contenido por separado. Los metadatos MIME pueden faltar, ser erróneos o estar controlados por quien carga el archivo; añadir un sufijo plausible no vuelve seguros unos bytes no fiables. Si su sistema ejecuta, previsualiza o publica el resultado, inspeccione primero el contenido y aplique la política de seguridad pertinente. La lista completa de extensiones ayuda a validar: normalice el sufijo del nombre existente y compruebe si aparece entre las alternativas, en vez de rechazar un jpeg legítimo porque la opción preferida sea jpg. Los tipos desconocidos producen un error explícito, ya que adivinar a partir del subtipo puede generar nombres engañosos o peligrosos. La tabla está incluida, por lo que una misma entrada siempre da la misma salida. La ejecución API cuesta $0.002 por elemento.