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 |
| 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.