add openapi specs

for new endpoint `/application/preferences`

api/v1/openapi.yaml

@@ -39,6 +39,8 @@ paths:
     $ref: "./openapi/paths/code-findByElement.yaml"
   /application/status:
     $ref: "./openapi/paths/application-status.yaml"
+  /application/preferences:
+    $ref: "./openapi/paths/application-preferences.yaml"
   /application/newID:
     $ref: "./openapi/paths/application-newID.yaml"
   /facets/{facet}:

api/v1/openapi/paths/application-preferences.yaml

@@ -0,0 +1,34 @@
+# /application/preferences path
+get:
+  tags:
+    - Application
+  summary: Get user preferences
+  responses:
+    200:
+      description: User preferences
+      content:
+        application/json:
+          schema:
+            $ref: '../schemas/preferences.yaml'
+    default:
+      $ref: '../responses/unexpectedError.yaml'
+
+post: 
+  tags:
+    - Application
+  summary: Set user preferences
+  requestBody:
+    description: User preferences
+    content: 
+      'application/json':
+        schema:
+          $ref: '../schemas/preferences.yaml'
+  responses:
+    200:
+      description: User preferences
+      content:
+        application/json:
+          schema:
+            $ref: '../schemas/preferences.yaml'
+    default:
+      $ref: '../responses/unexpectedError.yaml'

api/v1/openapi/schemas/preferences.yaml

@@ -0,0 +1,36 @@
+# preferences schema
+type: object
+properties:
+  line-wrap: 
+    type: boolean
+    description: Set line wrap for xml preview
+    default: true
+  limit:
+    type: integer
+    format: int32
+    description: Set the limit for list views
+    default: 10
+    enum:
+      - 10
+      - 25
+      - 50
+  rdg-marker:
+    type: boolean
+    description: Show reading markers within the text view 
+    default: false
+  textConst-marker:
+    type: boolean
+    description: Show text constitution markers within the text view 
+    default: true
+  supplied-marker:
+    type: boolean
+    description: Show supplied markers within the text view 
+    default: true
+  note-marker:
+    type: boolean
+    description: Show note markers within the text view 
+    default: true
+  thematicCommentaries-marker:
+    type: boolean
+    description: Show thematic commentaries markers within the text view 
+    default: true