diff --git a/backend/api/routes/openapi.py b/backend/api/routes/openapi.py index 7257e3ac..9cc80e29 100644 --- a/backend/api/routes/openapi.py +++ b/backend/api/routes/openapi.py @@ -105,6 +105,10 @@ async def get_cn_skills_by_job( ) -> SkillsListResponse: """ 获取职业技能列表 + + Args: + jobId (str): 职业ID,必填参数 + jobGrowId (str): 转职ID,必填参数 """ key = f'openapi:{jobId}:{jobGrowId}:skills' @@ -129,6 +133,12 @@ async def get_cn_skill_info( ) -> SkillDetailResponse: """ 获取技能详细信息 + + Args: + jobId (str): 职业ID,必填参数 + jobGrowId (str): 转职ID,必填参数 + skillId (str): 技能ID,必填参数 + level (int, optional): 技能等级,默认为None """ skill_info = {} key = f'openapi:{jobId}:{jobGrowId}:{skillId}' @@ -193,6 +203,11 @@ async def get_skill_data_summary( ) -> SkillDataSummaryResponse: """ 获取技能数据汇总信息 + + Args: + job (str): 职业名称,必填参数 + skills (str, optional): 技能列表字符串,逗号拼接技能名称,不传递或者传递为空时,查询所有技能,默认为'' + weapons (str, optional): 武器类型列表字符串,逗号拼接武器类型名称,不传递或者传递为空时,查询所有武器类型,默认为'' """ job = job.replace('(', '(').replace(')', ')') key = f'openapi:skillData:summary:{job}'