Saltar al contenido principal

Blog

API REST para la gestión de posts del blog del storefront.

Endpoints

Crear post

POST /api/v1/blog/posts
CampoTipoRequeridoDescripción
titlestringTítulo del post
slugstringNoURL slug (auto-generado si se omite)
contentstringNoContenido HTML
excerptstringNoExtracto corto
authorstringNoNombre del autor
featured_imagestringNoURL de imagen destacada
tags[]stringNoTags del post

Listar posts

GET /api/v1/blog/posts?status=published&limit=20&cursor=xxx
ParamTipoDescripción
statusstringFiltrar por estado: draft, published, archived
limitintCantidad de resultados
cursorstringCursor de paginación

Obtener post por ID

GET /api/v1/blog/posts/:id

Obtener post por slug

GET /api/v1/blog/posts/slug/:slug

Actualizar post

PATCH /api/v1/blog/posts/:id

Acepta los mismos campos que crear. Solo actualiza los campos enviados.

Publicar post

Cambia el estado del post de draft a published.

POST /api/v1/blog/posts/:id/publish

Archivar post

Cambia el estado a archived. El post ya no se muestra en el storefront.

DELETE /api/v1/blog/posts/:id

Estados de un post

EstadoDescripción
draftBorrador, no visible en el storefront
publishedPublicado y visible
archivedArchivado, no visible