update: add authenticated employment-history metadata endpoint

• update: add authenticated employment-history metadata endpoint

Includes information about which member organizations the individual has worked for previously that the foundation is aware of, along with the dates associated with those relationships

Resolves #121

spec/openapi.yaml

@@ -173,6 +173,39 @@ paths:
           description: Error while retrieving data.
       deprecated: false
 
+  /account/profile/{name}/employment-history:
+    get:
+      tags:
+        - User Metadata
+      summary: Retrieve user employment history via username
+      description: Retrieve employment history for a specified user.
+      operationId: getUserEmploymentHistory
+      security:
+        - OAuth2:
+            - eclipsefdn_view_all_profiles
+      parameters:
+        - name: name
+          in: path
+          description: An ef username.
+          required: true
+          style: simple
+          explode: false
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/EmploymentHistories"
+              example:
+                signed: true
+                can_contribute_spec_project: true
+        "500":
+          description: Error while retrieving data.
+      deprecated: false
+
   /account/profile/{name}/mailing-list:
     get:
       tags:
@@ -843,6 +876,35 @@ components:
           - list_name: epp
             list_description: Eclipse Packaging Project
 
+    EmploymentHistories:
+      type: array
+      items:
+        $ref: "#/components/schemas/EmploymentHistory"
+        
+    EmploymentHistory:
+      type: object
+      additionalProperties: false
+      required:
+        - organization_id
+        - organization_name
+        - start
+      properties:
+        organization_id:
+          type: number
+          description: Internal numerical ID of organization
+        organization_name:
+          type: string
+          description: The legal name of the organization
+        start:
+          type: string
+          description: Start or entry date of the user employment
+        end:
+          type:
+            - "null" 
+            - string
+          description: Termination or change date for employment
+        
+            
     MailingList:
       type: object
       additionalProperties: false