Commit a29c883b authored by Dmitriy Zaporozhets's avatar Dmitriy Zaporozhets

Merge pull request #3170 from Asquera/api/system_hooks_adjustments

API: system hook request functions and documentation updated
parents 269a9859 562de2a4
......@@ -8,7 +8,10 @@ Get list of system hooks
GET /hooks
```
Will return hooks with status `200 OK` on success, or `404 Not found` on fail.
Parameters:
+ **none**
## Add new system hook hook
......@@ -20,7 +23,6 @@ Parameters:
+ `url` (required) - The hook URL
Will return status `201 Created` on success, or `404 Not found` on fail.
## Test system hook
......@@ -32,10 +34,12 @@ Parameters:
+ `id` (required) - The ID of hook
Will return hook with status `200 OK` on success, or `404 Not found` on fail.
## Delete system hook
Deletes a system hook. This is an idempotent API function and returns `200 Ok` even if the hook
is not available. If the hook is deleted it is also returned as JSON.
```
DELETE /hooks/:id
```
......@@ -43,5 +47,3 @@ DELETE /hooks/:id
Parameters:
+ `id` (required) - The ID of hook
Will return status `200 OK` on success, or `404 Not found` on fail.
\ No newline at end of file
module Gitlab
# Hooks API
class SystemHooks < Grape::API
before { authenticated_as_admin! }
before {
authenticate!
authenticated_as_admin!
}
resource :hooks do
# Get the list of system hooks
......@@ -21,6 +24,7 @@ module Gitlab
# POST /hooks
post do
attrs = attributes_for_keys [:url]
required_attributes! [:url]
@hook = SystemHook.new attrs
if @hook.save
present @hook, with: Entities::Hook
......@@ -47,13 +51,19 @@ module Gitlab
data
end
# Delete a hook
# Delete a hook. This is an idempotent function.
#
# Parameters:
# id (required) - ID of the hook
# Example Request:
# DELETE /hooks/:id
delete ":id" do
begin
@hook = SystemHook.find(params[:id])
@hook.destroy
rescue
# SystemHook raises an Error if no hook with id found
end
end
end
end
......
......@@ -10,6 +10,13 @@ describe Gitlab::API do
before { stub_request(:post, hook.url) }
describe "GET /hooks" do
context "when no user" do
it "should return authentication error" do
get api("/hooks")
response.status.should == 401
end
end
context "when not an admin" do
it "should return forbidden error" do
get api("/hooks", user)
......@@ -34,9 +41,9 @@ describe Gitlab::API do
}.to change { SystemHook.count }.by(1)
end
it "should respond with 404 on failure" do
it "should respond with 400 if url not given" do
post api("/hooks", admin)
response.status.should == 404
response.status.should == 400
end
it "should not create new hook without url" do
......@@ -65,5 +72,10 @@ describe Gitlab::API do
delete api("/hooks/#{hook.id}", admin)
}.to change { SystemHook.count }.by(-1)
end
it "should return success if hook id not found" do
delete api("/hooks/12345", admin)
response.status.should == 200
end
end
end
\ No newline at end of file
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment