Herunterladen einer Datei in einem anderen Format

Mithilfe dieser API können Sie den Inhalt eines Elements in einem bestimmten Format abrufen. Nicht jede Datei kann in sämtliche Formate konvertiert werden.

Wie Sie das Element in seinem ursprünglichen Format herunterladen können, erfahren Sie unter Herunterladen des Inhalts von OneDrive-Elementen.

Voraussetzungen

Damit diese API aufgerufen werden kann, muss der Benutzer der Anwendung Lesezugriff auf die Datei gewährt haben, die von der App konvertiert werden soll.

HTTP-Anforderung

GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}

Optionale Anforderungsheader

Name	Wert	Beschreibung
if-none-match	Zeichenfolge	Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag (oder cTag) mit dem aktuellen Tag in der Datei übereinstimmt, wird die Antwort HTTP 304 Not Modified zurückgegeben.

Parameter der Abfragezeichenfolge

Name	Wert	Beschreibung
format	string	Hier geben Sie das Format an, in dem der Elementinhalt heruntergeladen werden soll.

Formatoptionen

Wert	Beschreibung	Unterstützte Quellerweiterungen
glb	Konvertiert das Element ins GLB-Format	cool, fbx, obj, ply, stl, 3mf
html	Konvertiert das Element ins HTML-Format	eml, md, msg
jpg	Konvertiert das Element ins JPG-Format	3g2, 3gp, 3gp2, 3gpp, 3mf, ai, arw, asf, avi, bas, bash, bat, bmp, c, cbl, cmd, cool, cpp, cr2, crw, cs, css, csv, cur, dcm, dcm30, dic, dicm, dicom, dng, doc, docx, dwg, eml, epi, eps, epsf, epsi, epub, erf, fbx, fppx, gif, glb, h, hcp, heic, heif, htm, html, ico, icon, java, jfif, jpeg, jpg, js, json, key, log, m2ts, m4a, m4v, markdown, md, mef, mov, movie, mp3, mp4, mp4v, mrw, msg, mts, nef, nrw, numbers, obj, odp, odt, ogg, orf, pages, pano, pdf, pef, php, pict, pl, ply, png, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, ps, ps1, psb, psd, py, raw, rb, rtf, rw1, rw2, sh, sketch, sql, sr2, stl, tif, tiff, ts, txt, vb, webm, wma, wmv, xaml, xbm, xcf, xd, xml, xpm, yaml, yml
pdf	Konvertiert das Element ins PDF-Format	doc, docx, epub, eml, htm, html, md, msg, odp, ods, odt, pps, ppsx, ppt, pptx, rtf, tif, tiff, xls, xlsm, xlsx

Beispiel

GET /drive/items/{item-id}/content?format={format}

Antwort

Die Methode gibt eine Antwort 302 Found zurück, die auf eine vorab authentifizierte URL zum Download der konvertierten Datei umleitet.

Um die konvertierte Datei herunterladen zu können, muss die App den Location-Header in der Antwort aufrufen.

Vorab authentifizierte URLs sind nur für eine kurze Zeit gültig (einige Minuten) und erfordern für den Zugriff keinen Authorization-Header.

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

Fehlerantworten

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.

Bekannte Probleme bei der Konvertierung von HTML in PDF

(1) Für eine optimale Leistungsfähigkeit stellen Sie sicher, dass HTML dem XHTML-Standard entspricht. Die Komponente arbeitet nicht so gut wie moderne Webbrowser, wenn es darum geht, HTML korrekt zu parsen, das nicht wohlgeformt ist, z. B. wenn in einer Tabellenzeile ein End-Tag fehlt ().

(2) Unter bestimmten Umständen werden nicht lateinische Zeichen nicht erwartungsgemäß gerendert. So ist beispielsweise eine Reihe vordefinierter Schriftarten für Sprachen wie Chinesisch installiert, aber wenn im HTML-Format keine allgemein bekannte Schriftart angegeben ist, kann die Komponente unter bestimmten Umständen nicht ermitteln, welche Schriftart verwendet werden soll, und das Zeichen wird nicht ordnungsgemäß angezeigt.

(3) Jede HTML-Datei wird in eine PDF-Datei im A4-Format umgewandelt. Wenn die Breite einer einzelnen HTML-Zeile größer als die Breite des Formats A4 ist, wird die Zeile beim PDF-Rendering abgeschnitten.