fix(api): update out of date cert api docs (#339)

Author: Joshua-Anderson

src/reference-guide/controller-api/v2.0.md

@@ -383,24 +383,35 @@ DEIS_PLATFORM_VERSION: 2.0.0
 Content-Type: application/json
 
 {
-    "count": 1,
-    "next": null,
-    "previous": null,
-    "results": [
-        {
-            "common_name": "test.example.com",
-            "expires": "2014-01-01T00:00:00UTC"
-        }
-    ]
+  "count": 1,
+  "next": null,
+  "previous": null,
+  "results": [
+    {
+      "id": 22,
+      "owner": "test",
+      "san": [],
+      "domains": [],
+      "created": "2016-06-22T22:24:20Z",
+      "updated": "2016-06-22T22:24:20Z",
+      "name": "foo",
+      "common_name": "bar.com",
+      "fingerprint": "7A:CA:B8:50:FF:8D:EB:03:3D:AC:AD:13:4F:EE:03:D5:5D:EB:5E:37:51:8C:E0:98:F8:1B:36:2B:20:83:0D:C0",
+      "expires": "2017-01-14T23:57:57Z",
+      "starts": "2016-01-15T23:57:57Z",
+      "issuer": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com",
+      "subject": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com"
+    }
+  ]
 }
 ```
 
-### List Certificate Details
+### Get Certificate Details
 
 Example Request:
 
 ```
-GET /v2/certs/test.example.com HTTP/1.1
+GET /v2/certs/foo HTTP/1.1
 Host: deis.example.com
 Authorization: token abc123
 ```
@@ -414,12 +425,19 @@ DEIS_PLATFORM_VERSION: 2.0.0
 Content-Type: application/json
 
 {
-    "updated": "2014-01-01T00:00:00UTC",
-    "created": "2014-01-01T00:00:00UTC",
-    "expires": "2015-01-01T00:00:00UTC",
-    "common_name": "test.example.com",
-    "owner": "test",
-    "id": 1
+  "id": 22,
+  "owner": "test",
+  "san": [],
+  "domains": [],
+  "created": "2016-06-22T22:24:20Z",
+  "updated": "2016-06-22T22:24:20Z",
+  "name": "foo",
+  "common_name": "bar.com",
+  "fingerprint": "7A:CA:B8:50:FF:8D:EB:03:3D:AC:AD:13:4F:EE:03:D5:5D:EB:5E:37:51:8C:E0:98:F8:1B:36:2B:20:83:0D:C0",
+  "expires": "2017-01-14T23:57:57Z",
+  "starts": "2016-01-15T23:57:57Z",
+  "issuer": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com",
+  "subject": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com"
 }
 ```
 
@@ -434,43 +452,83 @@ Content-Type: application/json
 Authorization: token abc123
 
 {
+    "name": "foo"
     "certificate": "-----BEGIN CERTIFICATE-----",
     "key": "-----BEGIN RSA PRIVATE KEY-----"
 }
 ```
 
-Optional Parameters:
+Example Response:
 
 ```
+HTTP/1.1 201 CREATED
+DEIS_API_VERSION: 2.0
+DEIS_PLATFORM_VERSION: 2.0.0
+Content-Type: application/json
+
 {
-    "common_name": "test.example.com"
+  "id": 22,
+  "owner": "test",
+  "san": [],
+  "domains": [],
+  "created": "2016-06-22T22:24:20Z",
+  "updated": "2016-06-22T22:24:20Z",
+  "name": "foo",
+  "common_name": "bar.com",
+  "fingerprint": "7A:CA:B8:50:FF:8D:EB:03:3D:AC:AD:13:4F:EE:03:D5:5D:EB:5E:37:51:8C:E0:98:F8:1B:36:2B:20:83:0D:C0",
+  "expires": "2017-01-14T23:57:57Z",
+  "starts": "2016-01-15T23:57:57Z",
+  "issuer": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com",
+  "subject": "/C=US/ST=CA/L=San Francisco/O=Deis/OU=Engineering/CN=bar.com/emailAddress=engineering@deis.com"
 }
 ```
 
+### Destroy a Certificate
+
+Example Request:
+
+```
+DELETE /v2/certs/foo HTTP/1.1
+Host: deis.example.com
+Authorization: token abc123
+```
+
 Example Response:
 
 ```
-HTTP/1.1 201 CREATED
+HTTP/1.1 204 NO CONTENT
 DEIS_API_VERSION: 2.0
 DEIS_PLATFORM_VERSION: 2.0.0
-Content-Type: application/json
+```
+
+### Attach a Domain to a Certificate
+
+Example Request:
+
+```
+POST /v2/certs/foo/domains/ HTTP/1.1
+Host: deis.example.com
+Authorization: token abc123
 
 {
-    "updated": "2014-01-01T00:00:00UTC",
-    "created": "2014-01-01T00:00:00UTC",
-    "expires": "2015-01-01T00:00:00UTC",
-    "common_name": "test.example.com",
-    "owner": "test",
-    "id": 1
+    "domain": "test.com"
 }
 ```
 
-### Destroy a Certificate
+Example Response:
+
+```
+HTTP/1.1 201 CREATED
+DEIS_API_VERSION: 2.0
+DEIS_PLATFORM_VERSION: 2.0.0
+```
+
+### Remove a Domain from a Certificate
 
 Example Request:
 
 ```
-DELETE /v2/certs/test.example.com HTTP/1.1
+DELETE /v2/certs/foo/domains/test.com/ HTTP/1.1
 Host: deis.example.com
 Authorization: token abc123
 ```