Téléversements d’images

Lorsque vous créez ou mettez à jour un article via l’API publique, vous pouvez inclure des images dans le corps de l’article à l’aide d’URL externes ou d’URL de données base64. L’API les téléverse vers Ferndesk et les enregistre comme chemins d’assets.

Points de terminaison

Le téléversement des images est géré automatiquement lorsque vous rédigez le contenu d’un article via ces points de terminaison :

• POST /articles

• PATCH /articles/:id

Sources d’images acceptées

Vous pouvez utiliser ces formats dans le champ src des nœuds d’image du corps de l’article :

• URL externes — URL absolues pointant vers des images hébergées ailleurs

• URL de données base64 — chaînes data:image/...;base64,...

• URL d’assets Ferndesk — images déjà hébergées par Ferndesk via https://static.ferndesk.com/user-images/...

Fonctionnement

Lorsque vous envoyez une requête d’écriture, l’API :

• Téléverse les URL externes et les URL de données base64 vers les serveurs Ferndesk

• Remplace les valeurs src d’origine dans l’article enregistré par les nouveaux chemins Ferndesk

• Laisse en place les images déjà hébergées par Ferndesk sans les téléverser à nouveau ; les URL statiques Ferndesk sont normalisées en chemins d’assets

Si la même source d’image apparaît plusieurs fois dans une requête, elle n’est téléversée qu’une seule fois et toutes les références partagent le même chemin.

Réponses d’erreur

Si une image ne peut pas être traitée, l’API renvoie une erreur explicite et l’article n’est pas enregistré.

Base64 malformé

400 avec :

{
  "error": "Image data URL must contain valid base64 data",
  "code": "invalid_request"
}

Échec du téléversement

502 avec :

{
  "error": "Unable to upload one or more article images",
  "code": "image_upload_failed"
}

Ressources associées

• Introduction à l’API Ferndesk

• Authentification