POST file using multipart/form-data in Rust
Zusammenfassung
Kurz
Der vollständige Bericht zeigt einen zweistufigen Datei-Upload mit Rust und `reqwest` für die Line Works API: erst eine Upload-URL anfordern, dann die Datei als Multipart-Formular mit passenden Feldnamen senden. Der Autor berichtet von Fehlern bei direktem Versand der Dateibytes und falsch benannten Formularfeldern; seine Hinweise beruhen auf eigenen Beispielen für diese API.
Mittel
Der vollständige Bericht erklärt anhand der Line Works API, wie man mit Rust und `reqwest` eine Datei als `multipart/form-data` hochlädt. Voraussetzung ist ein bereits gültiges Zugriffstoken. Zunächst wird mit einer authentifizierten POST-Anfrage und einem JSON-Body mit Dateinamen eine Upload-URL angefordert. Danach wird die Datei als Multipart-Formular an diese URL gesendet.
Als einfachen Weg empfiehlt der Autor, die Datei mit `fs::read` in einen Byte-Vektor einzulesen und daraus einen Multipart-Part zu erstellen. Seiner Erfahrung nach müssen dabei der Dateiname am Part sowie die Formularfelder `resourceName` und `FileData` korrekt gesetzt sein. Alternativ beschreibt er das Einlesen mit Tokio oder den Upload eines Dateistreams. Bei Erfolg enthalte die Antwort Datei-ID, Größe und Namen; ein anschließender Versand der Datei-ID in einer Bot-Nachricht soll laut Beispiel mit Status 201 gelingen.
Der Autor berichtet, dass ein direkter Request-Body aus Dateibytes bei ihm einen 400-Fehler mit `InvalidParameter` auslöste. Einen `IncompleteMessage`-Fehler führt er rückblickend auf einen falsch gesetzten Formularfeldnamen zurück. Diese Hinweise beruhen auf seinen Line-Works-Beispielen und sind keine allgemeine Aussage über andere APIs.
Ausführlich lesen
Der vollständige Bericht beschreibt, wie sich laut Autor mit Rust, `reqwest` und der Line Works API eine Datei per `multipart/form-data` hochladen lässt. Der Ablauf setzt ein bereits gültiges Zugriffstoken voraus; die Beschaffung des Tokens wird nicht behandelt. Für die HTTP-Anfragen verwendet das Beispiel `reqwest`, für JSON `serde_json` und optional Tokio für asynchrone Datei- und Netzwerkoperationen. Der Autor weist darauf hin, dass benötigte `reqwest`-Funktionen wie Multipart über Cargo-Features aktiviert werden müssen.
Der Upload besteht laut Bericht aus zwei API-Schritten. Zuerst sendet man eine authentifizierte POST-Anfrage an den Attachment-Endpunkt eines Bots. Der JSON-Body enthält den Dateinamen. Als Antwort erwartet der Autor unter anderem eine `uploadUrl` und eine `fileId`; das Beispiel liest die Upload-URL aus der JSON-Antwort aus.
Für den zweiten Schritt wird die Datei als Multipart-Formular an diese URL gesendet. Der Autor empfiehlt als einfachste Variante, die Datei mit `fs::read` als Byte-Vektor einzulesen, daraus mit `multipart::Part::bytes` einen Part zu erstellen und diesen in ein Formular einzufügen. Besonders betont er zwei Anforderungen, die er aus seiner Erfahrung mit der Line Works API ableitet: Der Part soll einen Dateinamen erhalten, und die Formularfelder sollen `resourceName` für den Dateinamen sowie `FileData` für den Datei-Part heißen. Ein Formular, dessen Part-Feld stattdessen direkt den Dateinamen trägt, habe bei ihm nicht der API-Erwartung entsprochen.
Als Alternativen nennt der Bericht das asynchrone Einlesen der Datei mit Tokio in einen Byte-Vektor oder das Übertragen eines Dateistreams über `multipart::Part::stream`. Nach erfolgreichem Upload soll die Antwort laut Beispiel Datei-ID, Dateigröße und Dateinamen enthalten. Der Autor berichtet außerdem, dass sich der Upload durch eine anschließende Nachricht an einen Nutzer testen lasse: Dafür wird die zurückgegebene Datei-ID in einer Nachricht vom Typ `image` verwendet; bei Erfolg habe sein Beispiel den HTTP-Status 201 ausgegeben.
Der Bericht schildert auch Fehlversuche. Das direkte Senden des Byte-Vektors als gewöhnlicher Request-Body habe bei ihm zu einem 400-Fehler mit `InvalidParameter` geführt. Einen Fehler `hyper::Error(IncompleteMessage)` führte er zunächst auf Timeout oder Hyper zurück, später nach eigener Einschätzung aber auf einen falsch gesetzten Formularfeldnamen. Die Hinweise und Ergebnisse beziehen sich auf seine Beispiele und die Line Works API; der Bericht liefert keinen systematischen Vergleich mit anderen Upload-APIs oder eine allgemeine Garantie, dass dieselben Feldnamen dort gelten.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Zusammenfassungen (kurz und mittel) wurden geprüft. Sie geben den Bericht sachlich korrekt wieder und enthalten keine erfundenen Angaben. Es lagen keine Sammel- oder Teilfragen vor, daher bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Der Kurztext nennt die Tokio-Alternativen zum Einlesen der Datei und den abschließenden Testschritt mit Bot-Nachricht nicht.
- Der Mitteltext erwähnt nicht, dass der Autor die Curl-Vorlage zunächst falsch als Feldname deutete.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.