Bild-Uploads
Wenn Sie einen Artikel über die öffentliche API erstellen oder aktualisieren, können Sie Bilder im Artikeltext mit externen URLs oder Base64-Data-URLs einfügen. Die API lädt sie zu Ferndesk hoch und speichert sie als Asset-Pfade.
Endpunkte
Das Hochladen von Bildern wird automatisch verarbeitet, wenn Sie Artikelinhalt über diese Endpunkte schreiben:
POST /articlesPATCH /articles/:id
Akzeptierte Bildquellen
Sie können diese Formate im Feld src von Bildknoten innerhalb des Artikeltexts verwenden:
Externe URLs — absolute URLs, die auf anderswo gehostete Bilder verweisen
Base64-Data-URLs — Zeichenfolgen im Format
data:image/...;base64,...Ferndesk-Asset-URLs — Bilder, die bereits von Ferndesk über
https://static.ferndesk.com/user-images/...gehostet werden
Was passiert
Wenn Sie eine Schreibanfrage senden, führt die API Folgendes aus:
Lädt externe URLs und Base64-Data-URLs auf die Ferndesk-Server hoch
Ersetzt die ursprünglichen
src-Werte im gespeicherten Artikel durch die neuen Ferndesk-PfadeLässt vorhandene, auf Ferndesk gehostete Bilder unverändert
Wenn dieselbe Bildquelle in einer Anfrage mehrmals vorkommt, wird sie einmal hochgeladen und alle Verweise teilen sich denselben Pfad.
Es gibt keinen eigenständigen öffentlichen API-Endpunkt zum Hochladen von Bildern. Fügen Sie Bilder direkt in den Artikeltext ein, wenn Sie POST /articles oder PATCH /articles/:id aufrufen, und der Upload erfolgt während des Schreibvorgangs.
Fehlermeldungen
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-Fehler
502 mit:
{
"error": "Unable to upload one or more article images",
"code": "image_upload_failed"
}