add new api

u2_api.yml

@@ -75,4 +75,51 @@ paths:
             application/json:
               schema: 
                 type: object
-        
+  /v1/promotion_super:
+    get: 
+      operationId: getPromotionSuper
+      summary: 魔法叠加
+      externalDocs: 
+        url: https://github.com/kysdm/u2_api#魔法叠加
+      parameters: 
+        - name: uid
+          schema: 
+            type: integer
+          in: query
+          description: u2账户id
+          required: true
+        - name: token
+          schema: 
+            type: string
+            format: password
+          in: query
+          description: 鉴权中返回的值
+          required: true
+        - name: torrent_id
+          schema: 
+            type: integer
+          in: query
+          description: 种子ID
+          required: true
+        - name: valid_uid
+          schema: 
+            type: integer
+          in: query
+          description: |
+            筛选对此用户生效的魔法(包含私有魔法)
+            默认为请求者的UID
+        - name: skip_cache
+          schema: 
+            type: integer
+            enum: [0, 1]
+          in: query
+          description: |
+            0 正常请求[默认]
+            1 跳过缓存请求
+      responses: 
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema: 
+                type: object