FEAT: Update Status Of Video Row On Media Convert Update

cms/docs/swagger.yaml

@@ -129,6 +129,51 @@ definitions:
         example: about:blank
         type: string
     type: object
+  api.VideoResponse:
+    properties:
+      categoryIds:
+        example:
+        - 1
+        - 2
+        items:
+          type: integer
+        type: array
+      createdAt:
+        type: string
+      description:
+        example: A behind-the-scenes look at the evening bulletin.
+        type: string
+      fileName:
+        example: interview-cut.mov
+        type: string
+      id:
+        example: 0199f3a1-7c2e-7b21-9f0d-1a2b3c4d5e6f
+        type: string
+      mediaConvertJobId:
+        example: 1755300000000-abcdef
+        type: string
+      sizeBytes:
+        example: 60
+        type: integer
+      status:
+        enum:
+        - processing
+        - ready
+        - failed
+        example: processing
+        type: string
+      storageKey:
+        example: videos/a1b2c3d4e5f6.mov
+        type: string
+      tags:
+        example: media, press, riyadh
+        type: string
+      title:
+        example: Inside the Newsroom
+        type: string
+      updatedAt:
+        type: string
+    type: object
 info:
   contact: {}
   description: 'JSON API for ingesting videos into the Thamanyah catalogue. Uploads
@@ -208,6 +253,36 @@ paths:
       summary: Register an uploaded video
       tags:
       - videos
+  /api/videos/{id}:
+    get:
+      description: 'Returns the catalogue record for one video, including the status
+        its transcoding job has reached. This is how a client follows an upload after
+        POST /api/videos: the record starts "processing" and moves to "ready" or "failed"
+        once MediaConvert reports the job finished.'
+      parameters:
+      - description: The video's id, as returned by POST /api/videos
+        in: path
+        name: id
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/api.VideoResponse'
+        "404":
+          description: No video has that id
+          schema:
+            $ref: '#/definitions/api.ProblemDetails'
+        "500":
+          description: The video could not be read from the database
+          schema:
+            $ref: '#/definitions/api.ProblemDetails'
+      summary: Read a video
+      tags:
+      - videos
   /api/videos/presign:
     post:
       consumes: