CEX-724 Add hypermedia links to workflow task definitions and routes (#1115)

* Add hypermedia links to workflow task definitions and routes

- Introduced `_links` property in `workflow_task.yaml` to provide hypermedia links related to workflow tasks, including `self` and `edit` links.
- Updated `workflows_tasks.yaml` to include `_links` for individual tasks in the response, ensuring clients can easily navigate to the task resource and its edit page.

* fix(workflows): update edit link for workflow tasks to public URL

* update swager json

---------

Co-authored-by: Paul Chasle <[email protected]>

Author: pchasle

content/swagger/akeneo-web-api.json

@@ -67,3 +67,26 @@ properties:
         {"locale": "en_US", "scope": null},
         {"locale": "fr_FR", "scope": null}
       ]
+  _links:
+    type: object
+    description: Hypermedia links related to the workflow task
+    properties:
+      self:
+        type: object
+        properties:
+          href:
+            type: string
+            format: uri
+            description: URI of this resource
+      edit:
+        type: object
+        properties:
+          href:
+            type: string
+            format: uri
+            description: The URL to access the task in Akeneo
+    example:
+      self:
+        href: "https://demo.akeneo.com/api/rest/v1/workflows/tasks/8f6c2d18-fbd4-4f7e-81df-cb3dc368fe07"
+      edit:
+        href: "https://demo.akeneo.com/public/workflows/tasks/8f6c2d18-fbd4-4f7e-81df-cb3dc368fe07/edit"

content/swagger/resources/workflows/definitions/workflow_task.yaml

@@ -53,6 +53,11 @@ get:
                     {"locale": "en_US", "scope": "ecommerce"},
                     {"locale": "fr_FR", "scope": "ecommerce"}
                   ]
+                _links:
+                  self:
+                    href: "https://demo.akeneo.com/api/rest/v1/workflows/tasks/8f6c2d18-fbd4-4f7e-81df-cb3dc368fe07"
+                  edit:
+                    href: "https://demo.akeneo.com/public/workflows/tasks/8f6c2d18-fbd4-4f7e-81df-cb3dc368fe07/edit"
               - uuid: "782dd26a-b58d-40d3-a8e2-c41bb342f20f"
                 status: "in_progress"
                 created_at: "2024-02-22T17:31:00Z"
@@ -67,6 +72,11 @@ get:
                     {"locale": "en_US", "scope": null},
                     {"locale": "fr_FR", "scope": null}
                   ]
+                _links:
+                  self:
+                    href: "https://demo.akeneo.com/api/rest/v1/workflows/tasks/782dd26a-b58d-40d3-a8e2-c41bb342f20f"
+                  edit:
+                    href: "https://demo.akeneo.com/public/workflows/tasks/782dd26a-b58d-40d3-a8e2-c41bb342f20f/edit"
     400:
       $ref: "#/responses/400Error"
     401: