Merge pull request #10672 from saraycp/person_groups

Document 'person/{login}/group' endpoint

src/api/public/apidocs-new/OBS-v2.10.50.yaml

@@ -71,6 +71,8 @@ paths:
     $ref: 'paths/person.yaml'
   /person/register:
     $ref: 'paths/person_register.yaml'
+  /person/{login}/group:
+    $ref: 'paths/person_login_group.yaml'
   /person/{login}/token:
     $ref: 'paths/person_login_token.yaml'
 

src/api/public/apidocs-new/paths/person_login_group.yaml

@@ -0,0 +1,38 @@
+get:
+  summary: List the groups of a person
+  description: List the groups the person belongs to.
+  security:
+    - basic_authentication: []
+  parameters:
+    - $ref: '../components/parameters/login.yaml'
+  responses:
+    '200':
+      description: >
+        OK. The request has succeeded.
+
+        XML Schema used for body validation: [directory.xsd](../schema/directory.xsd)
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/directory.yaml'
+          example:
+            count: '2'
+            entry:
+              - name: 'factory-maintainers'
+              - name: 'obs-developers'
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+    '404':
+      description: |
+        Not Found.
+
+        XML Schema used for body validation: [status.xsd](../schema/status.xsd)
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/api_response.yaml'
+          example:
+            code: not_found
+            summary: "Couldn't find User with login = fake"
+  tags:
+    - Person