Blog
API REST para la gestión de posts del blog del storefront.
Endpoints
Crear post
POST /api/v1/blog/posts
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | Sí | Título del post |
slug | string | No | URL slug (auto-generado si se omite) |
content | string | No | Contenido HTML |
excerpt | string | No | Extracto corto |
author | string | No | Nombre del autor |
featured_image | string | No | URL de imagen destacada |
tags | []string | No | Tags del post |
Listar posts
GET /api/v1/blog/posts?status=published&limit=20&cursor=xxx
| Param | Tipo | Descripción |
|---|---|---|
status | string | Filtrar por estado: draft, published, archived |
limit | int | Cantidad de resultados |
cursor | string | Cursor 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
| Estado | Descripción |
|---|---|
draft | Borrador, no visible en el storefront |
published | Publicado y visible |
archived | Archivado, no visible |