fix: 修改接口描述不规范问题

Author: Xinkai Yi

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/callback.py

@@ -54,7 +54,7 @@ class PluginCallback(APIView):
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="plugin callback",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/detail.py

@@ -69,15 +69,16 @@ class Detail(APIView):
     permission_classes = [permissions.AllowAny]
 
     @extend_schema(
-        summary="Get plugin detail for specific version",
+        summary="获取指定版本的插件详情",
+        operation_id="plugin_detail",
         responses={200: standard_response_enveloper(DetailResponseSerializer)},
         extensions=gen_apigateway_resource_config(
             is_public=True,
             allow_apply_permission=True,
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Get plugin detail for specific version",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/invoke.py

@@ -59,7 +59,7 @@ class Invoke(APIView):
     permission_classes = [ScopeAllowPermission]
 
     @extend_schema(
-        summary="插件调用",
+        summary="调用指定版本插件",
         operation_id="invoke",
         request=InvokeParamsSerializer,
         responses={200: standard_response_enveloper(InvokeResponseSerializer)},
@@ -69,7 +69,7 @@ class Invoke(APIView):
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Invoke specific version plugin",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/logs.py

@@ -45,15 +45,16 @@ class Logs(APIView):
     permission_classes = [permissions.AllowAny]
 
     @extend_schema(
-        summary="Get plugin execution log with trace_id",
+        summary="获取插件执行日志",
+        operation_id="plugin_logs",
         responses={200: standard_response_enveloper(LogsResponseSerializer)},
         extensions=gen_apigateway_resource_config(
             is_public=True,
             allow_apply_permission=True,
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Get plugin execution log with trace_id",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/meta.py

@@ -63,15 +63,16 @@ class Meta(APIView):
     permission_classes = [permissions.AllowAny]
 
     @extend_schema(
-        summary="Get plugin meta info",
+        summary="获取插件元信息",
+        operation_id="plugin_meta_info",
         responses={200: standard_response_enveloper(MetaResponseSerializer)},
         extensions=gen_apigateway_resource_config(
             is_public=True,
             allow_apply_permission=True,
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Get plugin meta info",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/plugin_api_dispatch.py

@@ -90,7 +90,7 @@ class PluginAPIDispatch(APIView):
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Plugin API dispatch",
             match_subpath=False,
         ),
     )

bk-plugin-framework/bk_plugin_framework/services/bpf_service/api/schedule.py

@@ -57,6 +57,8 @@ class Schedule(APIView):
 
     @extend_schema(
         summary="获取插件调度详情",
+        operation_id="plugin_schedule",
+        parameters=[ScheduleParamsSerializer],
         request=ScheduleParamsSerializer,
         responses={200: standard_response_enveloper(ScheduleResponseSerializer)},
         extensions=gen_apigateway_resource_config(
@@ -65,7 +67,7 @@ class Schedule(APIView):
             user_verified_required=True,
             app_verified_required=True,
             resource_permission_required=True,
-            description_en="插件调用",
+            description_en="Get plugin schedule detail with trace_id",
             match_subpath=False,
         ),
     )