[AGORA-1849] Formal OAS for Agora API (delegates, auth, pagination) (#…

…212)

* 💻📐 openapi swagger wip specification for /delegates
* 🤏 📃 🆚 bump version 3.1.0; add license; qualify beta
* 🏷️ rename to oas_v1.yaml
* 🔂 add CI/GHA file; integrate basic swagger linting
* 💻📐 add page metadata to OAS
* 📐 💻 add reusable datatypes for proposal, vote, delegation; routes for props
* 💫💻📐 add opt, approval, std, snapshot prop data; propType->votingStrategy; remove extended proposal
* 💻 /spec route for OAS
* 💻📐 add routes + contract schema

.github/workflows/ci.yml

@@ -9,11 +9,22 @@ on:
       - 'main'
 
 jobs:
-    lint-prettier:
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@v2
-            - name: Install dependencies
-              run: yarn install
-            - name: Lint with Prettier
-              run: yarn check-prettier
+  swagger_lint:
+    runs-on: ubuntu-latest
+    name: Swagger Editor Validator Remote
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Validate OpenAPI definition
+        uses: char0n/apidom-validate@v1
+        with:
+          fails-on: 2
+          definition-file: spec/oas_v1.yaml
+  lint-prettier:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install dependencies
+        run: yarn install
+      - name: Lint with Prettier
+        run: yarn check-prettier