Api Endpoints¶

api/services/<myservicename>¶

POST¶

POST api/services/<myservicename>¶

This endpoint will create a new service with the gates given.

Default values for all gates is open.

Your Service name must be unique. The gate name must not contain dots.

Example request:

POST /services/awesome_service HTTP/1.1
Content-Type: application/json
Payload: {
              "group": "team12",
              "environments": [
                  "testing",
                  "mylivegate"
              ]
          }

Positiv response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok"
}

Request Headers:
	Accept – application/json
Response Headers:
	Content-Type – application/json
Status Codes:	200 OK – no error 400 Bad Request – Your json contains invalid information 400 Bad Request – Json was not valid 400 Bad Request – Gate with this name already exist

GET¶

GET api/services/<myservicename>¶

Will get you the state of the gates in json format.

Example request:

GET /services/awesome_service HTTP/1.1
Accept: application/json

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "name": "awesome_service",
  "group": "team12",
  "environments": {
      "mylivegate": {
          "queue": [],
          "message_timestamp": "",
          "state": "closed",
          "message": "",
          "state_timestamp": "2015-10-27 12:05:38+0100"
      }
  }
}

Request Headers:
	Accept – application/json
Response Headers:
	Content-Type – application/json
Status Codes:	200 OK – no error 400 Bad Request – Json was not valid 400 Bad Request – Gate with this name already exist

DELETE¶

DELETE api/services/<myservicename>¶

Will remove a gate.

Example request:

DELETE api/services/awesome_service HTTP/1.1
Accept: application/json

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok"
}

Error response:

HTTP/1.1 400 BAD REQUEST
Content-Type: application/json

{
  "status": "error"
  "reason": "Json was not valid"
}

Request Headers:
	Accept – application/json
Response Headers:
	Content-Type – application/json
Status Codes:	200 OK – no error 400 Bad Request – Json was not valid 400 Bad Request – Gate with this name already exist 400 Bad Request – Your json contains invalid information 500 Internal Server Error – Can not write to database

api/services/<myservicename>/<environment>¶

PUT¶

PUT api/services/<myservicename>/<environment>¶

Lets you set the state of one single gate.

Only valid options are open and close.

Example request:

PUT api/services/awesome_service/live HTTP/1.1
Content-Type: application/json

{
  "state": "closed",
  "message": "I want to do some testing. -Jens"
}

Positiv response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok"
}

Request Headers:
	Accept – application/json
Response Headers:
	Content-Type – application/json
Status Codes:	200 OK – no error 400 Bad Request – Json was not valid 400 Bad Request – state must be open or closed 404 Not Found – Gate not found 500 Internal Server Error – Can not write to database

api/services¶

PUT¶

PUT api/services¶

With this you can close multiple gates at once and its provides a test-and-set functionality, which means that you only get a positive response if none of the gates you asking for is already closed.

This is useful if you want two gates to be mutually exclusive. As example we do not want to deploy our pipeline, if the pipeline is involved in an live deployment of an other service.

Example request:

PUT api/services HTTP/1.1
Content-Type: application/json

{
  "services": {
      "service12": ["myservicename"],
      "pipeline": ["meta"]
  }
}

Positiv response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok",
  "ticket": {
      "expiration_date": 0,
      "updated": "2016-01-26 09:35:18+0100",
      "link": "https://github.com/otto-de/gatekeeper",
      "id": "4ca72ee9-82b9-48c5-bf66-994ac907386b"
  }
}

Negativ response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "denied"
}

Queued response:

If the queue=true query is used and the gate is closed, you receive “queued” as response.

The ticket you get will be valid for 2 minutes. With every subsequent requests that includes the ticket id the tickets expiration date will be refreshed.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "queue",
  "ticket": {
      "expiration_date": 1453799405.26424,
      "updated": "2016-01-26 09:35:18+0100",
      "link": "https://github.com/otto-de/gatekeeper",
      "id": "4ca72ee9-82b9-48c5-bf66-994ac907386b"
  }
}

Example request with queued ticket:

To include your ticket id use the following request structure:

PUT api/services HTTP/1.1
Content-Type: application/json

{
  "services": {
      "service12": ["myservicename"],
      "pipeline": ["meta"]
  },
  "ticket": "4ca72ee9-82b9-48c5-bf66-994ac907386b"
}

Positiv Queued response:

The ticket expiration_date will be set to 0.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok",
  "ticket": {
      "expiration_date": 0,
      "updated": "2016-01-26 09:35:18+0100",
      "link": "https://github.com/otto-de/gatekeeper",
      "id": "4ca72ee9-82b9-48c5-bf66-994ac907386b"
  }
}

Negativ Queued response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "denied"
}

Still Queued response:

If its not yet your turn, the status will remain as queue.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "queue",
  "ticket": {
      "expiration_date": 1453799405.26424,
      "updated": "2016-01-26 09:35:18+0100",
      "link": "https://github.com/otto-de/gatekeeper",
      "id": "4ca72ee9-82b9-48c5-bf66-994ac907386b"
  }
}

Query Parameters:
	queue=true – creates a ticket and uses queueing
Request Headers:
	Accept – application/json
Response Headers:
	Content-Type – application/json
Status Codes:	200 OK – no error 400 Bad Request – Json was not valid 400 Bad Request – state must be open or closed 404 Not Found – Gate not found 500 Internal Server Error – Can not write to database

api/tickets/(ticket_id)¶

DELETE¶

DELETE api/tickets/(ticket_id)¶

This end

Example request:

DELETE api/tickets/8fb0cefd-34b9-4094-8cb4-8198e4f95737 HTTP/1.1
Accept: application/json

Positiv response:

HTTP/1.1 200 OK
Content-Type: application/json

{
      "status": "ok"
}

Status Codes:	200 OK – no error 404 Not Found – Ticket does not exist