#1 Add idempotency for post requests

Author: vityaman

matchmaker/api/src/main/resources/static/openapi/api.yml

@@ -92,6 +92,12 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/GeneralError"
+        409:
+          description: Attitude was already taken
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GeneralError"
   /people/{target_id}/attitudes/{attitude_kind}:
     post:
       tags: [SOA]
@@ -125,6 +131,12 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/GeneralError"
+        409:
+          description: Attitude was already taken
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GeneralError"
   /attitudes:
     delete:
       tags: [SOA]

people/api/src/main/resources/static/openapi/api.yml

@@ -196,6 +196,14 @@ paths:
       tags: [People]
       summary: Create a person
       description: Creates a person with given parameters
+      parameters:
+        - name: Idempotency-Key
+          in: header
+          required: true
+          schema:
+            type: string
+            format: uuid
+            example: 550e8400-e29b-41d4-a716-446655440000
       requestBody:
         required: true
         content:
@@ -221,6 +229,12 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/GeneralError"
+        409:
+          description: If person was already created (Idempotency-Key duplicated)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GeneralError"
   /people/{person_id}:
     get:
       tags: [People]