mirror of
https://github.com/discourse/discourse.git
synced 2024-11-27 18:43:38 +08:00
89f721cf67
This fixes the api documentation for the create invite api endpoint so that it uses the `group_ids` param when specifying the group instead of the incorrect `group_id` param.
123 lines
4.0 KiB
Ruby
123 lines
4.0 KiB
Ruby
# frozen_string_literal: true
|
|
require "swagger_helper"
|
|
|
|
RSpec.describe "invites" do
|
|
let(:"Api-Key") { Fabricate(:api_key).key }
|
|
let(:"Api-Username") { "system" }
|
|
|
|
path "/invites.json" do
|
|
post "Create an invite" do
|
|
tags "Invites"
|
|
operationId "createInvite"
|
|
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: :request_body,
|
|
in: :body,
|
|
schema: {
|
|
type: :object,
|
|
properties: {
|
|
email: {
|
|
type: :string,
|
|
example: "not-a-user-yet@example.com",
|
|
description: "required for email invites only",
|
|
},
|
|
skip_email: {
|
|
type: :boolean,
|
|
default: false,
|
|
},
|
|
custom_message: {
|
|
type: :string,
|
|
description: "optional, for email invites",
|
|
},
|
|
max_redemptions_allowed: {
|
|
type: :integer,
|
|
example: 5,
|
|
default: 1,
|
|
description: "optional, for link invites",
|
|
},
|
|
topic_id: {
|
|
type: :integer,
|
|
},
|
|
group_ids: {
|
|
type: :string,
|
|
description:
|
|
"Optional, either this or `group_names`. Comma separated list for multiple ids.",
|
|
example: "42,43",
|
|
},
|
|
group_names: {
|
|
type: :string,
|
|
description:
|
|
"Optional, either this or `group_ids`. Comma separated list for multiple names.",
|
|
example: "foo,bar",
|
|
},
|
|
expires_at: {
|
|
type: :string,
|
|
description:
|
|
"optional, if not supplied, the invite_expiry_days site setting is used",
|
|
},
|
|
},
|
|
}
|
|
|
|
produces "application/json"
|
|
response "200", "success response" do
|
|
schema type: :object,
|
|
properties: {
|
|
id: {
|
|
type: :integer,
|
|
example: 42,
|
|
},
|
|
link: {
|
|
type: :string,
|
|
example: "http://example.com/invites/9045fd767efe201ca60c6658bcf14158",
|
|
},
|
|
email: {
|
|
type: :string,
|
|
example: "not-a-user-yet@example.com",
|
|
},
|
|
emailed: {
|
|
type: :boolean,
|
|
example: false,
|
|
},
|
|
custom_message: {
|
|
type: %i[string null],
|
|
example: "Hello world!",
|
|
},
|
|
topics: {
|
|
type: :array,
|
|
items: {
|
|
},
|
|
example: [],
|
|
},
|
|
groups: {
|
|
type: :array,
|
|
items: {
|
|
},
|
|
example: [],
|
|
},
|
|
created_at: {
|
|
type: :string,
|
|
example: "2021-01-01T12:00:00.000Z",
|
|
},
|
|
updated_at: {
|
|
type: :string,
|
|
example: "2021-01-01T12:00:00.000Z",
|
|
},
|
|
expires_at: {
|
|
type: :string,
|
|
example: "2021-02-01T12:00:00.000Z",
|
|
},
|
|
expired: {
|
|
type: :boolean,
|
|
example: false,
|
|
},
|
|
}
|
|
|
|
let(:request_body) { { email: "not-a-user-yet@example.com" } }
|
|
run_test!
|
|
end
|
|
end
|
|
end
|
|
end
|