openapi: 3.0.3
info:
  title: ZDNet RSS Feed AI News API
  description: RSS feed endpoints from ZDNet covering enterprise IT, security, cloud, AI, development, and innovation news. Each feed returns RSS 2.0 XML content.
  version: 1.0.0
  contact:
    name: ZDNet
    url: https://www.zdnet.com
servers:
- url: https://www.zdnet.com
  description: ZDNet Production
tags:
- name: News
  description: General news feeds
paths:
  /news/rss.xml:
    get:
      operationId: getNewsRssFeed
      summary: ZDNet Get News RSS Feed
      description: Returns the latest news articles from ZDNet as an RSS 2.0 feed.
      tags:
      - News
      responses:
        '200':
          description: RSS 2.0 XML feed
          content:
            application/rss+xml:
              schema:
                $ref: '#/components/schemas/RssFeed'
              example: '<?xml version="1.0" encoding="UTF-8"?>

                <rss version="2.0"><channel><title>ZDNet</title></channel></rss>

                '
        '404':
          description: Feed not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                GetNewsRssFeed404Example:
                  summary: Default getNewsRssFeed 404 response
                  x-microcks-default: true
                  value:
                    message: Example description for this resource.
                    code: 100
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /topic/developer/rss.xml:
    get:
      operationId: getDeveloperRssFeed
      summary: ZDNet Get Developer RSS Feed
      description: Returns the latest developer-focused articles from ZDNet as an RSS 2.0 feed.
      tags:
      - News
      responses:
        '200':
          description: RSS 2.0 XML feed
          content:
            application/rss+xml:
              schema:
                $ref: '#/components/schemas/RssFeed'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /topic/innovation/rss.xml:
    get:
      operationId: getInnovationRssFeed
      summary: ZDNet Get Innovation RSS Feed
      description: Returns the latest innovation articles from ZDNet as an RSS 2.0 feed.
      tags:
      - News
      responses:
        '200':
          description: RSS 2.0 XML feed
          content:
            application/rss+xml:
              schema:
                $ref: '#/components/schemas/RssFeed'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    RssItem:
      type: object
      description: A single RSS feed article item.
      required:
      - title
      - link
      properties:
        title:
          type: string
          description: Article title.
          example: New AI breakthrough announced
        link:
          type: string
          format: uri
          description: Article URL.
          example: https://www.zdnet.com/article/example
        description:
          type: string
          description: Article summary.
          example: Article summary text.
        author:
          type: string
          description: Article author.
          example: Jane Smith
        pubDate:
          type: string
          format: date-time
          description: Publication date.
          example: '2026-05-01T12:00:00Z'
        category:
          type: array
          description: Article categories.
          items:
            type: string
          example:
          - AI
          - Innovation
        guid:
          type: string
          description: Unique article identifier.
          example: https://www.zdnet.com/article/example#guid
    RssFeed:
      type: object
      description: RSS 2.0 feed envelope describing a list of news articles.
      properties:
        title:
          type: string
          description: Feed title.
          example: ZDNet
        link:
          type: string
          format: uri
          description: Feed website URL.
          example: https://www.zdnet.com
        description:
          type: string
          description: Feed description.
          example: ZDNet news, analysis, and reviews.
        language:
          type: string
          description: Language code.
          example: en-US
        items:
          type: array
          description: List of article items.
          items:
            $ref: '#/components/schemas/RssItem'
          example:
          - {}
    Error:
      type: object
      description: Error response.
      properties:
        message:
          type: string
          description: Error message.
          example: Example description for this resource.
        code:
          type: integer
          description: Error code.
          example: 100