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 stocke sous forme de chemins de ressources.

Points de terminaison

Le téléversement d’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 image à l’intérieur 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 de ressources Ferndesk — images déjà hébergées par Ferndesk via https://static.ferndesk.com/user-images/...

Ce qui se passe

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 stocké par les nouveaux chemins Ferndesk

• Laisse inchangées les images déjà hébergées sur Ferndesk

Si la même source d’image apparaît plusieurs fois dans une même requête, elle est téléversée 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 mal formé

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