mirror of
https://github.com/discourse/discourse.git
synced 2024-12-12 22:14:03 +08:00
ee7809e8a8
From the openapi spec: https://spec.openapis.org/oas/latest.html#fixed-fields-7 each endpoint needs to have an `operationId`: > Unique string used to identify the operation. The id MUST be unique > among all operations described in the API. The operationId value is > case-sensitive. Tools and libraries MAY use the operationId to uniquely > identify an operation, therefore, it is RECOMMENDED to follow common > programming naming conventions. Running the linter on our openapi.json file with this command: `npx @redocly/openapi-cli lint openapi.json` produced the following warning on all of our endpoints: > Operation object should contain `operationId` field This commit resolves these warnings by adding an operationId field to each endpoint.
422 lines
15 KiB
Ruby
422 lines
15 KiB
Ruby
# frozen_string_literal: true
|
|
require 'swagger_helper'
|
|
|
|
describe 'posts' do
|
|
|
|
let(:'Api-Key') { Fabricate(:api_key).key }
|
|
let(:'Api-Username') { 'system' }
|
|
let(:admin) { Fabricate(:admin) }
|
|
|
|
before do
|
|
Jobs.run_immediately!
|
|
sign_in(admin)
|
|
end
|
|
|
|
path '/posts.json' do
|
|
|
|
get 'List latest posts across topics' do
|
|
tags 'Posts'
|
|
operationId 'listPosts'
|
|
parameter name: 'Api-Key', in: :header, type: :string, required: true
|
|
parameter name: 'Api-Username', in: :header, type: :string, required: true
|
|
produces 'application/json'
|
|
|
|
response '200', 'latest posts' do
|
|
schema type: :object, properties: {
|
|
latest_posts: {
|
|
type: :array,
|
|
items: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
name: { type: :string },
|
|
username: { type: :string },
|
|
avatar_template: { type: :string },
|
|
created_at: { type: :string },
|
|
cooked: { type: :string },
|
|
post_number: { type: :integer },
|
|
post_type: { type: :integer },
|
|
updated_at: { type: :string },
|
|
reply_count: { type: :integer },
|
|
reply_to_post_number: { type: [:string, :null] },
|
|
quote_count: { type: :integer },
|
|
incoming_link_count: { type: :integer },
|
|
reads: { type: :integer },
|
|
readers_count: { type: :integer },
|
|
score: { type: :number },
|
|
yours: { type: :boolean },
|
|
topic_id: { type: :integer },
|
|
topic_slug: { type: :string },
|
|
topic_title: { type: :string },
|
|
topic_html_title: { type: :string },
|
|
category_id: { type: :integer },
|
|
display_username: { type: :string },
|
|
primary_group_name: { type: [:string, :null] },
|
|
flair_name: { type: [:string, :null] },
|
|
flair_url: { type: [:string, :null] },
|
|
flair_bg_color: { type: [:string, :null] },
|
|
flair_color: { type: [:string, :null] },
|
|
version: { type: :integer },
|
|
can_edit: { type: :boolean },
|
|
can_delete: { type: :boolean },
|
|
can_recover: { type: :boolean },
|
|
can_wiki: { type: :boolean },
|
|
user_title: { type: [:string, :null] },
|
|
raw: { type: :string },
|
|
actions_summary: {
|
|
type: :array,
|
|
items: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
can_act: { type: :boolean },
|
|
}
|
|
},
|
|
},
|
|
moderator: { type: :boolean },
|
|
admin: { type: :boolean },
|
|
staff: { type: :boolean },
|
|
user_id: { type: :integer },
|
|
hidden: { type: :boolean },
|
|
trust_level: { type: :integer },
|
|
deleted_at: { type: [:string, :null] },
|
|
user_deleted: { type: :boolean },
|
|
edit_reason: { type: [:string, :null] },
|
|
can_view_edit_history: { type: :boolean },
|
|
wiki: { type: :boolean },
|
|
reviewable_id: { type: [:string, :null] },
|
|
reviewable_score_count: { type: :integer },
|
|
reviewable_score_pending_count: { type: :integer },
|
|
}
|
|
},
|
|
},
|
|
}
|
|
|
|
let!(:post) { Fabricate(:post) }
|
|
run_test!
|
|
end
|
|
end
|
|
|
|
post 'Creates a new topic, a new post, or a private message' do
|
|
tags 'Posts', 'Topics', 'Private Messages'
|
|
operationId 'createTopicPostPM'
|
|
consumes 'application/json'
|
|
expected_request_schema = load_spec_schema('topic_create_request')
|
|
parameter name: :params, in: :body, schema: expected_request_schema
|
|
|
|
produces 'application/json'
|
|
response '200', 'post created' do
|
|
expected_response_schema = load_spec_schema('topic_create_response')
|
|
schema expected_response_schema
|
|
|
|
let(:params) { Fabricate(:post) }
|
|
|
|
it_behaves_like "a JSON endpoint", 200 do
|
|
let(:expected_response_schema) { expected_response_schema }
|
|
let(:expected_request_schema) { expected_request_schema }
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
path '/posts/{id}.json' do
|
|
|
|
get 'Retrieve a single post' do
|
|
tags 'Posts'
|
|
operationId 'getPost'
|
|
parameter name: 'Api-Key', in: :header, type: :string, required: true
|
|
parameter name: 'Api-Username', in: :header, type: :string, required: true
|
|
parameter name: :id, in: :path, schema: { type: :string }
|
|
|
|
produces 'application/json'
|
|
|
|
response '200', 'latest posts' do
|
|
schema type: :object, properties: {
|
|
id: { type: :integer },
|
|
name: { type: [:string, :null] },
|
|
username: { type: :string },
|
|
avatar_template: { type: :string },
|
|
created_at: { type: :string },
|
|
cooked: { type: :string },
|
|
post_number: { type: :integer },
|
|
post_type: { type: :integer },
|
|
updated_at: { type: :string },
|
|
reply_count: { type: :integer },
|
|
reply_to_post_number: { type: [:string, :null] },
|
|
quote_count: { type: :integer },
|
|
incoming_link_count: { type: :integer },
|
|
reads: { type: :integer },
|
|
readers_count: { type: :integer },
|
|
score: { type: :integer },
|
|
yours: { type: :boolean },
|
|
topic_id: { type: :integer },
|
|
topic_slug: { type: :string },
|
|
display_username: { type: [:string, :null] },
|
|
primary_group_name: { type: [:string, :null] },
|
|
flair_name: { type: [:string, :null] },
|
|
flair_url: { type: [:string, :null] },
|
|
flair_bg_color: { type: [:string, :null] },
|
|
flair_color: { type: [:string, :null] },
|
|
version: { type: :integer },
|
|
can_edit: { type: :boolean },
|
|
can_delete: { type: :boolean },
|
|
can_recover: { type: :boolean },
|
|
can_wiki: { type: :boolean },
|
|
user_title: { type: [:string, :null] },
|
|
raw: { type: :string },
|
|
actions_summary: {
|
|
type: :array,
|
|
items: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
can_act: { type: :boolean },
|
|
}
|
|
},
|
|
},
|
|
moderator: { type: :boolean },
|
|
admin: { type: :boolean },
|
|
staff: { type: :boolean },
|
|
user_id: { type: :integer },
|
|
hidden: { type: :boolean },
|
|
trust_level: { type: :integer },
|
|
deleted_at: { type: [:string, :null] },
|
|
user_deleted: { type: :boolean },
|
|
edit_reason: { type: [:string, :null] },
|
|
can_view_edit_history: { type: :boolean },
|
|
wiki: { type: :boolean },
|
|
reviewable_id: { type: [:string, :null] },
|
|
reviewable_score_count: { type: :integer },
|
|
reviewable_score_pending_count: { type: :integer },
|
|
}
|
|
|
|
let(:id) { Fabricate(:post).id }
|
|
run_test!
|
|
end
|
|
end
|
|
|
|
put 'Update a single post' do
|
|
tags 'Posts'
|
|
operationId 'updatePost'
|
|
consumes 'application/json'
|
|
parameter name: 'Api-Key', in: :header, type: :string, required: true
|
|
parameter name: 'Api-Username', in: :header, type: :string, required: true
|
|
parameter name: :id, in: :path, schema: { type: :string }
|
|
|
|
parameter name: :post_body, in: :body, schema: {
|
|
type: :object,
|
|
properties: {
|
|
post: {
|
|
type: :object,
|
|
properties: {
|
|
raw: { type: :string },
|
|
edit_reason: { type: :string },
|
|
}, required: [ 'raw' ]
|
|
}
|
|
}
|
|
}
|
|
|
|
produces 'application/json'
|
|
response '200', 'post updated' do
|
|
schema type: :object, properties: {
|
|
post: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
name: { type: [:string, :null] },
|
|
username: { type: :string },
|
|
avatar_template: { type: :string },
|
|
created_at: { type: :string },
|
|
cooked: { type: :string },
|
|
post_number: { type: :integer },
|
|
post_type: { type: :integer },
|
|
updated_at: { type: :string },
|
|
reply_count: { type: :integer },
|
|
reply_to_post_number: { type: [:string, :null] },
|
|
quote_count: { type: :integer },
|
|
incoming_link_count: { type: :integer },
|
|
reads: { type: :integer },
|
|
readers_count: { type: :integer },
|
|
score: { type: :number },
|
|
yours: { type: :boolean },
|
|
topic_id: { type: :integer },
|
|
topic_slug: { type: :string },
|
|
display_username: { type: [:string, :null] },
|
|
primary_group_name: { type: [:string, :null] },
|
|
flair_url: { type: [:string, :null] },
|
|
flair_bg_color: { type: [:string, :null] },
|
|
flair_color: { type: [:string, :null] },
|
|
version: { type: :integer },
|
|
can_edit: { type: :boolean },
|
|
can_delete: { type: :boolean },
|
|
can_recover: { type: :boolean },
|
|
can_wiki: { type: :boolean },
|
|
user_title: { type: [:string, :null] },
|
|
actions_summary: {
|
|
type: :array,
|
|
items: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
can_act: { type: :boolean },
|
|
}
|
|
},
|
|
},
|
|
moderator: { type: :boolean },
|
|
admin: { type: :boolean },
|
|
staff: { type: :boolean },
|
|
user_id: { type: :integer },
|
|
draft_sequence: { type: :integer },
|
|
hidden: { type: :boolean },
|
|
trust_level: { type: :integer },
|
|
deleted_at: { type: [:string, :null] },
|
|
user_deleted: { type: :boolean },
|
|
edit_reason: { type: [:string, :null] },
|
|
can_view_edit_history: { type: :boolean },
|
|
wiki: { type: :boolean },
|
|
reviewable_id: { type: [:string, :null] },
|
|
reviewable_score_count: { type: :integer },
|
|
reviewable_score_pending_count: { type: :integer },
|
|
}
|
|
},
|
|
}
|
|
|
|
let(:post_body) { { 'post': { 'raw': 'Updated content!', 'edit_reason': 'fixed typo' } } }
|
|
let(:id) { Fabricate(:post).id }
|
|
|
|
run_test! do |response|
|
|
data = JSON.parse(response.body)
|
|
expect(data['post']['cooked']).to eq("<p>Updated content!</p>")
|
|
expect(data['post']['edit_reason']).to eq("fixed typo")
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
path '/posts/{id}/locked.json' do
|
|
put 'Lock a post from being edited' do
|
|
tags 'Posts'
|
|
operationId 'lockPost'
|
|
consumes 'application/json'
|
|
parameter name: 'Api-Key', in: :header, type: :string, required: true
|
|
parameter name: 'Api-Username', in: :header, type: :string, required: true
|
|
parameter name: :id, in: :path, schema: { type: :string }
|
|
|
|
parameter name: :post_body, in: :body, schema: {
|
|
type: :object,
|
|
properties: {
|
|
locked: { type: :boolean }
|
|
}, required: [ 'locked' ]
|
|
}
|
|
|
|
produces 'application/json'
|
|
response '200', 'post updated' do
|
|
schema type: :object, properties: {
|
|
locked: { type: :boolean },
|
|
}
|
|
|
|
let(:post_body) { { 'locked': 'true' } }
|
|
let(:id) { Fabricate(:post).id }
|
|
|
|
run_test! do |response|
|
|
data = JSON.parse(response.body)
|
|
expect(data['locked']).to eq(true)
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
path '/post_actions.json' do
|
|
post 'Like a post and other actions' do
|
|
tags 'Posts'
|
|
operationId 'performPostAction'
|
|
consumes 'application/json'
|
|
parameter name: 'Api-Key', in: :header, type: :string, required: true
|
|
parameter name: 'Api-Username', in: :header, type: :string, required: true
|
|
|
|
parameter name: :post_body, in: :body, schema: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
post_action_type_id: { type: :integer },
|
|
flag_topic: { type: :boolean },
|
|
}, required: [ 'id', 'post_action_type_id' ]
|
|
}
|
|
|
|
produces 'application/json'
|
|
response '200', 'post updated' do
|
|
schema type: :object, properties: {
|
|
id: { type: :integer },
|
|
name: { type: :string },
|
|
username: { type: :string },
|
|
avatar_template: { type: :string },
|
|
created_at: { type: :string },
|
|
cooked: { type: :string },
|
|
post_number: { type: :integer },
|
|
post_type: { type: :integer },
|
|
updated_at: { type: :string },
|
|
reply_count: { type: :integer },
|
|
reply_to_post_number: { type: [:string, :null] },
|
|
quote_count: { type: :integer },
|
|
incoming_link_count: { type: :integer },
|
|
reads: { type: :integer },
|
|
readers_count: { type: :integer },
|
|
score: { type: :number },
|
|
yours: { type: :boolean },
|
|
topic_id: { type: :integer },
|
|
topic_slug: { type: :string },
|
|
display_username: { type: :string },
|
|
primary_group_name: { type: [:string, :null] },
|
|
flair_name: { type: [:string, :null] },
|
|
flair_url: { type: [:string, :null] },
|
|
flair_bg_color: { type: [:string, :null] },
|
|
flair_color: { type: [:string, :null] },
|
|
version: { type: :integer },
|
|
can_edit: { type: :boolean },
|
|
can_delete: { type: :boolean },
|
|
can_recover: { type: :boolean },
|
|
can_wiki: { type: :boolean },
|
|
user_title: { type: [:string, :null] },
|
|
actions_summary: {
|
|
type: :array,
|
|
items: {
|
|
type: :object,
|
|
properties: {
|
|
id: { type: :integer },
|
|
count: { type: :integer },
|
|
acted: { type: :boolean },
|
|
can_undo: { type: :boolean },
|
|
}
|
|
},
|
|
},
|
|
moderator: { type: :boolean },
|
|
admin: { type: :boolean },
|
|
staff: { type: :boolean },
|
|
user_id: { type: :integer },
|
|
hidden: { type: :boolean },
|
|
trust_level: { type: :integer },
|
|
deleted_at: { type: [:string, :null] },
|
|
user_deleted: { type: :boolean },
|
|
edit_reason: { type: [:string, :null] },
|
|
can_view_edit_history: { type: :boolean },
|
|
wiki: { type: :boolean },
|
|
notice: { type: :object },
|
|
reviewable_id: { type: [:string, :null] },
|
|
reviewable_score_count: { type: :integer },
|
|
reviewable_score_pending_count: { type: :integer },
|
|
}
|
|
|
|
let(:id) { Fabricate(:post).id }
|
|
let(:post_body) { { id: id, post_action_type_id: 2 } }
|
|
|
|
run_test! do |response|
|
|
data = JSON.parse(response.body)
|
|
expect(data['actions_summary'][0]['id']).to eq(2)
|
|
expect(data['actions_summary'][0]['count']).to eq(1)
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
end
|