Bild-Uploads
Wenn Sie über die öffentliche API einen Artikel erstellen oder aktualisieren, können Sie Bilder über externe URLs oder Base64-Daten-URLs in den Artikelinhalt einfügen. Die API lädt sie zu Ferndesk hoch und speichert sie als Asset-Pfade.
Endpunkte
Das Hochladen von Bildern wird automatisch durchgeführt, wenn Sie Artikelinhalte über diese Endpunkte schreiben:
POST /articlesPATCH /articles/:id
Unterstützte Bildquellen
Sie können diese Formate im Feld src von Bildknoten innerhalb des Artikelinhalts verwenden:
Externe URLs — absolute URLs, die auf Bilder verweisen, die an anderer Stelle gehostet werden
Base64-Daten-URLs — Zeichenfolgen im Format
data:image/...;base64,...Ferndesk-Asset-URLs — Bilder, die bereits über
https://static.ferndesk.com/user-images/...von Ferndesk gehostet werden
Was passiert
Wenn Sie eine Schreibanfrage senden, führt die API Folgendes aus:
Lädt externe URLs und Base64-Daten-URLs auf Ferndesk-Server hoch
Ersetzt die ursprünglichen
src-Werte im gespeicherten Artikel durch die neuen Ferndesk-PfadeLässt bereits von Ferndesk gehostete Bilder unverändert, ohne sie erneut hochzuladen; statische Ferndesk-URLs werden in Asset-Pfade normalisiert
Wenn dieselbe Bildquelle in einer Anfrage mehrfach vorkommt, wird sie einmal hochgeladen und alle Verweise verwenden denselben Pfad.
Es gibt keinen eigenständigen öffentlichen API-Endpunkt zum Hochladen von Bildern. Fügen Sie Bilder direkt in den Artikelinhalt ein, wenn Sie POST /articles oder PATCH /articles/:id aufrufen. Der Upload erfolgt während des Schreibvorgangs.
Fehlerantworten
Wenn ein Bild nicht verarbeitet werden kann, gibt die API einen eindeutigen Fehler zurück und der Artikel wird nicht gespeichert.
Fehlerhaftes Base64
400 mit:
{
"error": "Image data URL must contain valid base64 data",
"code": "invalid_request"
}Upload fehlgeschlagen
502 mit:
{
"error": "Unable to upload one or more article images",
"code": "image_upload_failed"
}