📝 Add job import/export endpoints

Author: jmleroux

content/swagger/akeneo-web-api.json

@@ -37,6 +37,11 @@
 /api/rest/v1/media-files/{code}/download:
   $ref: ./resources/media_files/routes/media_files_code_download.yaml
 
+/api/rest/v1/job/export/{code}:
+  $ref: ./resources/job/routes/export.yaml
+/api/rest/v1/job/import/{code}:
+  $ref: ./resources/job/routes/import.yaml
+
 /api/rest/v1/families:
   $ref: ./resources/families/routes/families.yaml
 /api/rest/v1/families/{code}:

content/swagger/paths.yaml

@@ -0,0 +1,25 @@
+post:
+  summary: Launch export job by code
+  operationId: "post_job_export"
+  tags:
+    - Job
+  x-versions:
+    - "SaaS"
+  description: This endpoint allows you to launch an export job by code.
+  parameters:
+    - name: code
+      in: path
+      type: string
+      description: Job code
+      required: true
+  responses:
+    200:
+      description: OK
+      x-details: Returns the execution ID for the launched job
+      x-examples-per-version:
+        - x-version: 'SaaS'
+          x-example: {"execution_id": "12345"}
+    404:
+      $ref: "#/responses/404Error"
+    422:
+      $ref: "#/responses/422Error"

content/swagger/resources/job/routes/export.yaml

@@ -0,0 +1,33 @@
+post:
+  summary: Launch import job by code
+  operationId: "post_job_import"
+  tags:
+    - Job
+  x-versions:
+    - "SaaS"
+  description: This endpoint allows you to launch an import job by code.
+  parameters:
+    - name: code
+      in: path
+      type: string
+      description: Job code
+      required: true
+    - name: body
+      in: body
+      schema:
+        properties:
+          import_mode:
+            type: string
+            description: Optional. Change the import mode for this job by overriding the profile value.
+            format: binary
+  responses:
+    200:
+      description: OK
+      x-details: Returns the execution ID for the launched job
+      x-examples-per-version:
+        - x-version: 'SaaS'
+          x-example: {"execution_id": "12345"}
+    404:
+      $ref: "#/responses/404Error"
+    422:
+      $ref: "#/responses/422Error"

content/swagger/resources/job/routes/import.yaml

@@ -82,6 +82,8 @@ function determineCategory(tag){
             return 'Catalogs for Apps';
         case 'UI Extensions':
             return 'Extensions';
+        case 'Job':
+            return 'Job';
         default:
             return 'Utilities';
     }