企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 一、概述 基于平台构建的业务系统发布后端的时候,自动会附带一个调试客户端,一般地址为: ``` http://ip:port/app/doc.html ``` ![](https://img.kancloud.cn/2c/6c/2c6cd1605733b927b0e3f6176a9d6e63_1366x736.png) ## 二、典型步骤 以下面的接口为例; ![](https://img.kancloud.cn/30/2d/302d86ee7b8e3fee0c86446261f15587_1366x736.png) 步骤1、调用登陆校验接口(002系统登陆校验接口的账号登陆验证接口),获取token,并执行登陆逻辑; ![](https://img.kancloud.cn/63/09/63097f599482a0a2c9302cecf97f4659_323x295.png) 步骤2、获取到当前分配的appId和appSecret,使用辅助开发工具,生成raySignature和rayTimeStamp,填充到字段; 步骤3、提供业务参数(如果接口是需要提供token作为头部的,大部分都是这种,则需要提供token,一般推荐第一次测试的时候,通过登陆校验接口,获取到token,保存起来,供后续复制即可),完成测试; ![](https://img.kancloud.cn/94/14/941484c0acc08898ffe6b77a87404462_1152x648.png) ## 三、优化步骤 ### **优化方案** 步骤1,在测试阶段,可优化,直接复制token,而不是必须通过登陆操作来获取,简化测试; 步骤2,在测试阶段,可优化,设置平台免于验证,简化测试; ### **配置方法** 通过修改application-ray.properties,实现上述优化方案; ``` ## 免验证token必须来自登陆动作,优化免去步骤1 rayframework.enabled.validate-token-by-login=false ## 免验证客户端合法性,优化免去步骤2 rayframework.enabled.validate-request=false rayframework.enabled.validate-request-per-api=false ``` >[danger] 需要注意的是,正式发布的时候,别忘记改回去了; ### **结论** 只需要执行步骤3,即可; ### **如何快速定位接口** 内置的接口调试工具,具备快速搜索功能,调试阶段,能够方便开发者快速找到需要调试的接口定义页面; ![](https://img.kancloud.cn/9e/b2/9eb281dc01f5c75b35161c6381e2d9d3_1129x553.png)