Cargas de imágenes
Cuando creas o actualizas un artículo a través de la API pública, puedes incluir imágenes en el cuerpo del artículo usando URLs externas o URLs de datos en base64. La API las sube a Ferndesk y las almacena como rutas de recursos.
Endpoints
La carga de imágenes se gestiona automáticamente cuando escribes contenido de artículo a través de estos endpoints:
POST /articlesPATCH /articles/:id
Fuentes de imágenes aceptadas
Puedes usar estos formatos en el campo src de los nodos de imagen dentro del cuerpo del artículo:
URLs externas — URLs absolutas que apuntan a imágenes alojadas en otro lugar
URLs de datos en base64 — cadenas
data:image/...;base64,...URLs de recursos de Ferndesk — imágenes ya alojadas por Ferndesk a través de
https://static.ferndesk.com/user-images/...
Qué sucede
Cuando envías una solicitud de escritura, la API:
Carga las URLs externas y las URLs de datos en base64 en los servidores de Ferndesk
Sustituye los valores originales de
srcen el artículo almacenado por las nuevas rutas de FerndeskDeja sin cambios las imágenes ya alojadas en Ferndesk
Si la misma fuente de imagen aparece varias veces en una solicitud, se carga una sola vez y todas las referencias comparten la misma ruta.
No existe un endpoint público de API independiente para cargar imágenes. Incluye las imágenes directamente en el cuerpo del artículo cuando llames a POST /articles o PATCH /articles/:id, y la carga ocurre durante la escritura.
Respuestas de error
Si una imagen no puede procesarse, la API devuelve un error explícito y el artículo no se guarda.
Base64 mal formado
400 con:
{
"error": "Image data URL must contain valid base64 data",
"code": "invalid_request"
}Error de carga
502 con:
{
"error": "Unable to upload one or more article images",
"code": "image_upload_failed"
}