2014-02-03 19:24:49 +00:00
|
|
|
# Copyright (C) 2012-2014 Zammad Foundation, http://zammad-foundation.org/
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-04-13 13:51:10 +00:00
|
|
|
class ChannelsController < ApplicationController
|
2015-05-07 11:23:55 +00:00
|
|
|
before_action :authentication_check
|
2012-04-13 13:51:10 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Format:
|
|
|
|
JSON
|
|
|
|
|
|
|
|
Example:
|
|
|
|
{
|
|
|
|
"id":1,
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
"group_id:": 1,
|
|
|
|
"options":{
|
|
|
|
"host":"mail.example.com",
|
|
|
|
"user":"some_user",
|
|
|
|
"password":"some_password",
|
|
|
|
"ssl":true
|
|
|
|
},
|
|
|
|
"active":true,
|
|
|
|
"updated_at":"2012-09-14T17:51:53Z",
|
|
|
|
"created_at":"2012-09-14T17:51:53Z",
|
|
|
|
"updated_by_id":2.
|
|
|
|
"created_by_id":2,
|
|
|
|
}
|
|
|
|
|
|
|
|
{
|
|
|
|
"id":1,
|
|
|
|
"area":"Twitter::Inbound",
|
2015-07-02 15:13:04 +00:00
|
|
|
"adapter":"Twitter",
|
2012-09-20 12:08:02 +00:00
|
|
|
"group_id:": 1,
|
|
|
|
"options":{
|
2015-07-07 11:57:45 +00:00
|
|
|
"auth": {
|
2015-07-02 15:13:04 +00:00
|
|
|
"consumer_key":"PJ4c3dYYRtSZZZdOKo8ow",
|
|
|
|
"consumer_secret":"ggAdnJE2Al1Vv0cwwvX5bdvKOieFs0vjCIh5M8Dxk",
|
|
|
|
"oauth_token":"293437546-xxRa9g74CercnU5AvY1uQwLLGIYrV1ezYtpX8oKW",
|
|
|
|
"oauth_token_secret":"ju0E4l9OdY2Lh1iTKMymAu6XVfOaU2oGxmcbIMRZQK4",
|
|
|
|
},
|
|
|
|
"sync":{
|
|
|
|
"search":[
|
|
|
|
{
|
2015-07-09 09:38:06 +00:00
|
|
|
"term":"#otrs",
|
2015-07-02 15:13:04 +00:00
|
|
|
"type": "mixed", # optional, possible 'mixed' (default), 'recent', 'popular'
|
2015-07-03 09:42:54 +00:00
|
|
|
"group_id:": 1,
|
2015-07-02 15:13:04 +00:00
|
|
|
"limit": 1, # optional
|
|
|
|
},
|
|
|
|
{
|
2015-07-09 09:38:06 +00:00
|
|
|
"term":"#zombie23",
|
2015-07-03 09:42:54 +00:00
|
|
|
"group_id:": 2,
|
2015-07-02 15:13:04 +00:00
|
|
|
},
|
|
|
|
{
|
2015-07-09 09:38:06 +00:00
|
|
|
"term":"#otterhub",
|
2015-07-03 09:42:54 +00:00
|
|
|
"group_id:": 3,
|
2015-07-02 15:13:04 +00:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"mentions" {
|
2015-07-03 09:42:54 +00:00
|
|
|
"group_id:": 4,
|
2015-07-02 15:13:04 +00:00
|
|
|
"limit": 100, # optional
|
2012-09-20 12:08:02 +00:00
|
|
|
},
|
2015-07-02 15:13:04 +00:00
|
|
|
"direct_messages": {
|
2015-07-03 09:42:54 +00:00
|
|
|
"group_id:": 4,
|
2015-07-02 15:13:04 +00:00
|
|
|
"limit": 1, # optional
|
2012-09-20 12:08:02 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"active":true,
|
|
|
|
"updated_at":"2012-09-14T17:51:53Z",
|
|
|
|
"created_at":"2012-09-14T17:51:53Z",
|
|
|
|
"updated_by_id":2.
|
|
|
|
"created_by_id":2,
|
|
|
|
}
|
|
|
|
|
|
|
|
=end
|
|
|
|
|
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2013-08-06 22:10:28 +00:00
|
|
|
GET /api/v1/channels.json
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Response:
|
|
|
|
[
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
...
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"id": 2,
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
...
|
|
|
|
}
|
|
|
|
]
|
|
|
|
|
|
|
|
Test:
|
2013-08-06 22:10:28 +00:00
|
|
|
curl http://localhost/api/v1/channels.json -v -u #{login}:#{password}
|
2012-04-13 13:51:10 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
def index
|
2015-02-15 09:12:27 +00:00
|
|
|
return if deny_if_not_role(Z_ROLENAME_ADMIN)
|
2012-09-20 12:08:02 +00:00
|
|
|
model_index_render(Channel, params)
|
2012-04-13 13:51:10 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2013-08-06 22:10:28 +00:00
|
|
|
GET /api/v1/channels/#{id}.json
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
...
|
|
|
|
}
|
2012-04-13 13:51:10 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
Test:
|
2013-08-06 22:10:28 +00:00
|
|
|
curl http://localhost/api/v1/channels/#{id}.json -v -u #{login}:#{password}
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
def show
|
2015-02-15 09:12:27 +00:00
|
|
|
return if deny_if_not_role(Z_ROLENAME_ADMIN)
|
2012-09-20 12:08:02 +00:00
|
|
|
model_show_render(Channel, params)
|
2012-04-13 13:51:10 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2013-08-06 22:10:28 +00:00
|
|
|
POST /api/v1/channels.json
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Payload:
|
|
|
|
{
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
"group_id:": 1,
|
|
|
|
"options":{
|
|
|
|
"host":"mail.example.com",
|
|
|
|
"user":"some_user",
|
|
|
|
"password":"some_password",
|
|
|
|
"ssl":true
|
|
|
|
},
|
|
|
|
"active":true,
|
|
|
|
}
|
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
...
|
|
|
|
}
|
|
|
|
|
|
|
|
Test:
|
2013-08-06 22:10:28 +00:00
|
|
|
curl http://localhost/api/v1/channels.json -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-13 13:51:10 +00:00
|
|
|
def create
|
2015-02-15 09:12:27 +00:00
|
|
|
return if deny_if_not_role(Z_ROLENAME_ADMIN)
|
2012-09-20 12:08:02 +00:00
|
|
|
model_create_render(Channel, params)
|
2012-04-13 13:51:10 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2013-08-06 22:10:28 +00:00
|
|
|
PUT /api/v1/channels/{id}.json
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
Payload:
|
|
|
|
{
|
|
|
|
"id":1,
|
|
|
|
"area":"Email::Inbound",
|
|
|
|
"adapter":"IMAP",
|
|
|
|
"group_id:": 1,
|
|
|
|
"options":{
|
|
|
|
"host":"mail.example.com",
|
|
|
|
"user":"some_user",
|
|
|
|
"password":"some_password",
|
|
|
|
"ssl":true
|
|
|
|
},
|
|
|
|
"active":true,
|
|
|
|
}
|
|
|
|
|
|
|
|
Response:
|
|
|
|
{
|
|
|
|
"id": 1,
|
|
|
|
"name": "some_name",
|
|
|
|
...
|
|
|
|
}
|
|
|
|
|
|
|
|
Test:
|
2013-08-06 22:10:28 +00:00
|
|
|
curl http://localhost/api/v1/channels.json -v -u #{login}:#{password} -H "Content-Type: application/json" -X PUT -d '{"name": "some_name","active": true, "note": "some note"}'
|
2012-04-13 13:51:10 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=end
|
|
|
|
|
|
|
|
def update
|
2015-02-15 09:12:27 +00:00
|
|
|
return if deny_if_not_role(Z_ROLENAME_ADMIN)
|
2012-09-20 12:08:02 +00:00
|
|
|
model_update_render(Channel, params)
|
2012-04-13 13:51:10 +00:00
|
|
|
end
|
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
Resource:
|
2013-08-06 22:10:28 +00:00
|
|
|
DELETE /api/v1/channels/{id}.json
|
2012-04-13 13:51:10 +00:00
|
|
|
|
2012-09-20 12:08:02 +00:00
|
|
|
Response:
|
|
|
|
{}
|
|
|
|
|
|
|
|
Test:
|
2013-08-06 22:10:28 +00:00
|
|
|
curl http://localhost/api/v1/channels.json -v -u #{login}:#{password} -H "Content-Type: application/json" -X DELETE
|
2012-09-20 12:08:02 +00:00
|
|
|
|
|
|
|
=end
|
|
|
|
|
|
|
|
def destroy
|
2015-02-15 09:12:27 +00:00
|
|
|
return if deny_if_not_role(Z_ROLENAME_ADMIN)
|
2012-09-20 12:08:02 +00:00
|
|
|
model_destory_render(Channel, params)
|
2012-04-13 13:51:10 +00:00
|
|
|
end
|
|
|
|
end
|