Content API

The content service manages blog posts, promotional banners, and friend links.

Public Endpoints

List Published Posts

GET /content/posts?limit=20&offset=0

Returns published blog posts in reverse chronological order.

Get Post by Slug

GET /content/posts/:slug

List Banners

GET /content/banners

Returns enabled banners in display order.

List Friend Links

GET /content/friend-links

Returns enabled friend links in display order.

Admin Endpoints

Blog Posts

Method	Path	Description
GET	/admin/posts	List all posts (including drafts)
POST	/admin/posts	Create a post
PUT	/admin/posts/:id	Update a post
DELETE	/admin/posts/:id	Delete a post

Create/Update Post Body:

{
  "title": "Post Title",
  "slug": "post-title",
  "content": "# Markdown content...",
  "excerpt": "Brief summary",
  "status": "draft",
  "tags": ["tutorial", "getting-started"]
}

Banners

Method	Path	Description
GET	/admin/banners	List all banners
POST	/admin/banners	Create a banner
PUT	/admin/banners/:id	Update a banner
DELETE	/admin/banners/:id	Delete a banner

Friend Links

Method	Path	Description
GET	/admin/friend-links	List all friend links
POST	/admin/friend-links	Create a friend link
PUT	/admin/friend-links/:id	Update a friend link
DELETE	/admin/friend-links/:id	Delete a friend link