ISSUE-337: name fix

.github/workflows/restapi-docs.yml

@@ -31,13 +31,13 @@ jobs:
         run: composer install --no-interaction --prefer-dist
 
       - name: Generate OpenAPI Specification JSON
-        run: vendor/bin/openapi -o docs/openapi.json --format json src
+        run: vendor/bin/openapi -o docs/latest-restapi.json --format json src
 
       - name: Upload REST API Specification
         uses: actions/upload-artifact@v3
         with:
-          name: openapi-json
-          path: docs/openapi.json
+          name: restapi-json
+          path: docs/latest-restapi.json
 
   deploy-docs:
     name: Deploy REST API Specification
@@ -50,7 +50,7 @@ jobs:
           node-version: 14
 
       - name: Install openapi-checker
-        run: npm install -g openapi-checker
+        run:  npm install -g swagger-cli
 
       - name: Checkout REST API Docs Repository
         uses: actions/checkout@v3
@@ -63,12 +63,13 @@ jobs:
         uses: actions/download-artifact@v3
         with:
           name: restapi-json
+          path: docs
 
       - name: Validate OpenAPI Specification
-        run: openapi-checker docs/openapi.json
+        run: swagger-cli validate docs/latest-restapi.json
 
       - name: Compare Specifications
-        run: git diff --no-index --output=restapi-diff.txt docs/openapi.json restapi.json || true
+        run: git diff --no-index --output=restapi-diff.txt docs/latest-restapi.json restapi.json || true
 
       - name: Check Differences and Decide Deployment
         id: allow-deploy
@@ -84,9 +85,9 @@ jobs:
       - name: Commit and Deploy Updates
         if: env.DEPLOY == 'true'
         run: |
-          mv docs/openapi.json docs/restapi.json
+          mv docs/latest-restapi.json docs/restapi.json
           git config user.name "github-actions"
           git config user.email "[email protected]"
           git add docs/restapi.json
           git commit -m "Update REST API documentation `date`"
-          git push origin main --force
+          git push