Téléversement d’images
Insérez directement des images dans le corps d’un article : l’API les téléverse dans votre centre d’aide lorsque vous appelez POST /articles ou PATCH /articles/:id. Elle remplace chaque src par le chemin de la copie stockée. Il n’existe pas de point de terminaison distinct pour le téléversement.
Sources acceptées
Source | Ce qui se passe |
|---|---|
Une URL | Téléchargée et stockée. Les URL commençant par |
Une URL | Décodée et stockée. Les URL de données volumineuses génèrent des requêtes volumineuses ; pour les grandes images, privilégiez une URL hébergée. |
Une URL sur un hôte | La valeur est conservée telle quelle. Les URL statiques de Ferndesk sont raccourcies en chemins. |
La même source utilisée plusieurs fois dans une requête n’est téléversée qu’une seule fois.
Règles concernant les URL
L’URL doit pointer vers une adresse publique. Cette vérification est répétée à chaque redirection, avec un maximum de 5 redirections.
Les fichiers téléchargés peuvent peser jusqu’à 50 MiB et doivent être récupérés en 45 secondes maximum. Les fichiers SVG peuvent peser jusqu’à 2 MiB et sont nettoyés avant d’être stockés.
Les images sont stockées au format JPG, PNG, GIF, WebP, SVG ou BMP. Les fichiers HTML, XML, JavaScript et les exécutables sont refusés, quel que soit leur nom.
Erreurs
Si le téléversement d’une image échoue, l’article n’est pas enregistré.
Statut | Corps | Cause |
|---|---|---|
|
| URL de données mal formée. Le champ |
|
| Impossible de télécharger ou de stocker une image. Vérifiez que son URL est publique et respecte les limites. |