GET RSS Feed

Endpoints: /rss and /rss.xml

Description: Returns an RSS 2.0 feed of recently modified releases with optional filtering.

Parameters

• product_name - Filter by exact product name (case-sensitive)
• release_type - Filter by exact release type
• release_status - Filter by exact release status
• limit - Maximum number of items (1-25, default: 25)

Examples

GET JSON API

Endpoint: /api/releases

Description: Returns JSON array of releases with optional filtering. No limit applied.

Parameters

• product_name - Filter by exact product name (case-sensitive)
• release_type - Filter by exact release type
• release_status - Filter by exact release status
• modified_within_days - Show items modified within N days (1-30)

Examples

Response Format

All responses include proper HTTP caching headers:

• ETag: Conditional requests supported (304 Not Modified)
• Cache-Control: 24-hour fresh cache with stale-while-revalidate
• Last-Modified: RFC 2822 formatted timestamp

JSON Response Schema

[
  {
    "release_item_id": "uuid",
    "feature_name": "string",
    "release_date": "YYYY-MM-DD",
    "release_type": "string",
    "release_status": "string", 
    "product_id": "uuid",
    "product_name": "string",
    "feature_description": "string",
    "last_modified": "YYYY-MM-DD"
  }
]

Caching & Performance

Our system uses Redis-backed caching with stale-while-revalidate strategy:

• Fresh Window: 24 hours - served immediately from cache
• Stale Window: Additional 24 hours - served from cache while refreshing in background
• Cache Keys: Unique per filter combination for optimal performance
• Background Refresh: Prevents stampeding and ensures fresh data