2021-06-01 12:20:20 +00:00
|
|
|
# Copyright (C) 2012-2021 Zammad Foundation, http://zammad-foundation.org/
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-04-10 14:06:46 +00:00
|
|
|
class GroupsController < ApplicationController
|
2020-03-19 09:39:51 +00:00
|
|
|
prepend_before_action { authentication_check && authorize! }
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Format:
|
|
|
|
JSON
|
|
|
|
|
|
|
|
Example:
|
|
|
|
{
|
|
|
|
"id":1,
|
|
|
|
"name":"some group",
|
|
|
|
"assignment_timeout": null,
|
|
|
|
"follow_up_assignment": true,
|
|
|
|
"follow_up_possible": "yes",
|
|
|
|
"note":"",
|
|
|
|
"active":true,
|
|
|
|
"updated_at":"2012-09-14T17:51:53Z",
|
|
|
|
"created_at":"2012-09-14T17:51:53Z",
|
|
|
|
"created_by_id":2,
|
|
|
|
}
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2016-06-06 06:34:15 +00:00
|
|
|
GET /api/v1/groups
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Response:
|
|
|
|
[
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"name": "some_name1",
|
|
|
|
...
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"id": 2,
|
|
|
|
"name": "some_name2",
|
|
|
|
...
|
|
|
|
}
|
|
|
|
]
|
|
|
|
|
|
|
|
Test:
|
2016-06-06 06:34:15 +00:00
|
|
|
curl http://localhost/api/v1/groups -v -u #{login}:#{password}
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
=end
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
def index
|
|
|
|
model_index_render(Group, params)
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2016-06-06 06:34:15 +00:00
|
|
|
GET /api/v1/groups/#{id}
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"name": "name_1",
|
|
|
|
...
|
|
|
|
}
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
Test:
|
2016-06-06 06:34:15 +00:00
|
|
|
curl http://localhost/api/v1/groups/#{id} -v -u #{login}:#{password}
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
def show
|
|
|
|
model_show_render(Group, params)
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2016-06-06 06:34:15 +00:00
|
|
|
POST /api/v1/groups
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Payload:
|
|
|
|
{
|
|
|
|
"name": "some name",
|
|
|
|
"assignment_timeout": null,
|
|
|
|
"follow_up_assignment": true,
|
|
|
|
"follow_up_possible": "yes",
|
|
|
|
"note":"",
|
|
|
|
"active":true,
|
|
|
|
}
|
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"name": "some_name",
|
|
|
|
...
|
|
|
|
}
|
|
|
|
|
|
|
|
Test:
|
2016-06-06 06:34:15 +00:00
|
|
|
curl http://localhost/api/v1/groups -v -u #{login}:#{password} -H "Content-Type: application/json" -X POST -d '{"name": "some_name","active": true, "note": "some note"}'
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
=end
|
|
|
|
|
2012-04-10 14:06:46 +00:00
|
|
|
def create
|
2012-09-20 12:08:02 +00:00
|
|
|
model_create_render(Group, params)
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2016-06-06 06:34:15 +00:00
|
|
|
PUT /api/v1/groups/{id}
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Payload:
|
|
|
|
{
|
|
|
|
"name": "some name",
|
|
|
|
"assignment_timeout": null,
|
|
|
|
"follow_up_assignment": true,
|
|
|
|
"follow_up_possible": "yes",
|
|
|
|
"note":"",
|
|
|
|
"active":true,
|
|
|
|
}
|
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"name": "some_name",
|
|
|
|
...
|
|
|
|
}
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
Test:
|
2016-06-06 06:34:15 +00:00
|
|
|
curl http://localhost/api/v1/groups -v -u #{login}:#{password} -H "Content-Type: application/json" -X PUT -d '{"name": "some_name","active": true, "note": "some note"}'
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
=end
|
|
|
|
|
|
|
|
def update
|
|
|
|
model_update_render(Group, params)
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
Resource:
|
2016-06-06 06:34:15 +00:00
|
|
|
DELETE /api/v1/groups/{id}
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Response:
|
2016-06-06 06:34:15 +00:00
|
|
|
{}
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Test:
|
2016-06-06 06:34:15 +00:00
|
|
|
curl http://localhost/api/v1/groups/{id} -v -u #{login}:#{password} -H "Content-Type: application/json" -X DELETE -d '{}'
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
def destroy
|
2021-11-09 08:11:21 +00:00
|
|
|
model_references_check(Group, params)
|
2016-11-30 10:30:03 +00:00
|
|
|
model_destroy_render(Group, params)
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
end
|