discourse/spec/requests/api/notifications_spec.rb
Blake Erickson 33982c0c9e DEV: Document notifications and tags api endpoints
Added some more specs that will be used to auto generate the api docs.
2020-08-07 14:30:54 -06:00

85 lines
2.3 KiB
Ruby

# frozen_string_literal: true
require 'swagger_helper'
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'
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, nullable: true },
topic_id: { type: :integer, nullable: true },
slug: { type: :string, nullable: true },
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'
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