diff options
author | David Lawrence <dkl@mozilla.com> | 2016-10-12 21:45:15 +0000 |
---|---|---|
committer | Michał Górny <mgorny@gentoo.org> | 2020-03-30 21:12:09 +0200 |
commit | ec0193eb43cec46cf0b4812b9833acdbf53cfe3f (patch) | |
tree | 2b9a40974f23dc17e94009af7c39898004d10a54 /docs | |
parent | remove SuperH from CC (diff) | |
download | bugzilla-ec0193eb43cec46cf0b4812b9833acdbf53cfe3f.tar.gz bugzilla-ec0193eb43cec46cf0b4812b9833acdbf53cfe3f.tar.bz2 bugzilla-ec0193eb43cec46cf0b4812b9833acdbf53cfe3f.zip |
Bug 1307003 - Add whoami endpointgentoo-5.0.6.3
r=dylan
(cherry picked from commit 31651c978e921e9e46cddd455f103fcf4b1a332a)
(rebased for 5.0 by mgorny)
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/en/rst/api/core/v1/user.rst | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/docs/en/rst/api/core/v1/user.rst b/docs/en/rst/api/core/v1/user.rst index e27211a7f..7f835cc8a 100644 --- a/docs/en/rst/api/core/v1/user.rst +++ b/docs/en/rst/api/core/v1/user.rst @@ -378,3 +378,38 @@ and not in 'editusers' group, you will only be returned the ``id``, ``name``, returned are filtered based on your permission to bless each group. The ``saved_searches`` and ``saved_reports`` items are only returned if you are querying your own account, even if you are in the editusers group. + +.. _rest_user_whoami: + +Who Am I +-------- + +Allows for validating a user's API key, token, or username and password. +If sucessfully authenticated, it returns simple information about the +logged in user. + +**Request** + +.. code-block:: text + + GET /rest/whoami + +**Response** + +.. code-block:: js + + { + "id" : "1234", + "name" : "user@bugzulla.org", + "real_name" : "Test User", + } + +========== ====== ===================================================== +name type description +========== ====== ===================================================== +id int The unique integer ID that Bugzilla uses to represent + this user. Even if the user's login name changes, + this will not change. +real_name string The actual name of the user. May be blank. +name string string The login name of the user. +========== ====== ===================================================== |