Carga de imágenes
Cuando creas o actualizas un artículo mediante la API pública, puedes incluir imágenes en el cuerpo del artículo usando URL externas o URL de datos en base64. La API las carga en Ferndesk y las almacena como rutas de recursos.
Endpoints
La carga de imágenes se gestiona automáticamente cuando escribes contenido de artículos mediante 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:
URL externas — URL absolutas que apuntan a imágenes alojadas en otro lugar
URL de datos en base64 — cadenas
data:image/...;base64,...URL de recursos de Ferndesk — imágenes ya alojadas en Ferndesk mediante
https://static.ferndesk.com/user-images/...
Qué sucede
Cuando envías una solicitud de escritura, la API:
Carga las URL externas y las URL de datos en base64 en los servidores de Ferndesk
Reemplaza los valores
srcoriginales del artículo almacenado por las nuevas rutas de FerndeskDeja en su lugar las imágenes existentes alojadas en Ferndesk sin volver a cargarlas; las URL estáticas de Ferndesk se normalizan como rutas de recursos
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 ningún endpoint independiente de la API pública para cargar imágenes. Incluye las imágenes directamente en el cuerpo del artículo cuando llames a POST /articles o PATCH /articles/:id; la carga se realiza durante la escritura.
Respuestas de error
Si no se puede procesar una imagen, la API devuelve un error explícito y el artículo no se guarda.
Base64 con formato incorrecto
400 con:
{
"error": "Image data URL must contain valid base64 data",
"code": "invalid_request"
}Fallo en la carga
502 con:
{
"error": "Unable to upload one or more article images",
"code": "image_upload_failed"
}