Reorganize api-ref: v3 os-pki

Reorganize as per the documentation session at PTG:
https://etherpad.openstack.org/p/queens-ptg-keystone-doc-cleanup

Change-Id: Ia0409c9f257b592bbca4ee33183b2a7c868291bb

api-ref/source/v3/index.rst

@@ -199,7 +199,7 @@ This page lists the Identity API operations in the following order:
 * `Unified Limits`_
 * `Users`_
 * `OS-INHERIT`_
-* `OS-PKI API`_
+* `OS-PKI`_
 
 .. rest_expand_all::
 

api-ref/source/v3/os-pki.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
 ==========
-OS-PKI API
+OS-PKI
 ==========
 
 List revoked tokens
@@ -9,24 +9,42 @@ List revoked tokens
 
 .. rest_method:: GET /v3/auth/tokens/OS-PKI/revoked
 
+Lists revoked PKI tokens.
+
 Relationship:
 ``https://docs.openstack.org/api/openstack-identity/3/rel/tokens/OS-PKI/revoked``
 
-Lists revoked PKI tokens.
-
-Normal response codes: 200
-
-Error response codes: 413,415,405,404,403,401,400,503,409
-
 Response
 --------
 
+Parameters
+~~~~~~~~~~
+
 .. rest_parameters:: parameters.yaml
 
    - signed: signed
 
-Response Example
-----------------
+Status Codes
+~~~~~~~~~~~~
+
+.. rest_status_code:: success status.yaml
+
+   - 200
+
+.. rest_status_code:: error status.yaml
+
+   - 413
+   - 415
+   - 405
+   - 404
+   - 403
+   - 401
+   - 400
+   - 503
+   - 409
+
+Example
+~~~~~~~
 
 .. literalinclude:: samples/admin/get-pki-revoked-response.json
-   :language: javascript
+   :language: javascript