discourse/spec/requests/api/notifications_spec.rb

# frozen_string_literal: true
require 'swagger_helper'

RSpec.describe 'notifications' do

  let(:admin) { Fabricate(:admin) }
  let!(:notification) { Fabricate(:notification, user: admin) }

  before do
    Jobs.run_immediately!
    sign_in(admin)
  end

  path '/notifications.json' do

    get 'Get the notifications that belong to the current user' do
      tags 'Notifications'
      operationId 'getNotifications'

      produces 'application/json'
      response '200', 'notifications' do
        schema type: :object, properties: {
          notifications: {
            type: :array,
            items: {
              type: :object,
              properties: {
                id: { type: :integer },
                user_id: { type: :integer },
                notification_type: { type: :integer },
                read: { type: :boolean },
                created_at: { type: :string },
                post_number: { type: [:string, :null] },
                topic_id: { type: [:integer, :null] },
                slug: { type: [:string, :null] },
                data: {
                  type: :object,
                  properties: {
                    badge_id: { type: :integer },
                    badge_name: { type: :string },
                    badge_slug: { type: :string },
                    badge_title: { type: :boolean },
                    username: { type: :string },
                  }
                },
              }
            },
          },
          total_rows_notifications: { type: :integer },
          seen_notification_id: { type: :integer },
          load_more_notifications: { type: :string },
        }

        run_test!
      end
    end

  end

  path '/notifications/mark-read.json' do

    put 'Mark notifications as read' do
      tags 'Notifications'
      operationId 'markNotificationsAsRead'
      consumes 'application/json'
      parameter name: :notification, in: :body, schema: {
        type: :object,
        properties: {
          id: {
            type: :integer,
            description: '(optional) Leave off to mark all notifications as read'
          }
        },
      }

      produces 'application/json'
      response '200', 'notifications marked read' do
        schema type: :object, properties: {
          success: { type: :string },
        }

        run_test!
      end
    end
  end
end