👉 开发前必看

# 开发说明 >[EasyDoc](https://easydoc.net/a/) 支持类型在线调试,参数、链接点击即可轻松复制,红色参数表示必须参数,灰色参数表示可选参数……(参见[产品首页](https://easydoc.net/))([完整功能](https://easydoc.net/s/31322154/uOeIUcm6/zqMrVVl8)) > 本项目的接口按照RestFul设计原则进行,有关http相关知识可以参阅[学习](https://easydoc.net/a/) ## 1. 文档说明 大多数情况下,文档将参数已经将参数说明得很清楚了,这里强调不能直接测试的情况: - **URL路径变量**(path variable)采用“:+参数名称”的方式,这个变量区别于测试板块的“URL参数”,(即问号后面的参数(e.g. info?mode=xxx)) ![image.png](https://cos.easydoc.net/97788718/files/kzbfpmby.png) - 使用**post请求**测试时注意content-type,绝大多数情况采用json,用form-data会出现问题,可以勾选raw后在点击自动生成json,选择合适的参数并填入即可 ![image.png](https://cos.easydoc.net/97788718/files/kzbfu7tf.png) ## 2. 在线文档快速调试使用帮助: ### 2.1 URL 手册需要收费才能自动填域名,所以需要手动补充,目前的测试地址是 http://120.24.191.224/ ,也可以通过如下方式快速进参数和域名的自动补充 也可以通过两个变量来替换对应的域名 测试环境`{{host_test}}` 正式环境`{{host_pro}}` - 点击文档此处 ![image.png](https://cos.easydoc.net/97788718/files/kzbg41vt.png) - 点击测试的历史记录![image.png](https://cos.easydoc.net/97788718/files/kzbg53r0.png) ### 2.2 常用变量添加 token设计时,有效期为1天;由于大部分业务需要认证才能进行操作,很多请求头参数都包含,避免频繁填写可以有以下两种示例方式 - 添加全局变量![image.png](https://cos.easydoc.net/97788718/files/kzbgzxrt.png) 使用时用“**{{}}**”填入自定义的变量名替换即可,如图 ![image.png](https://cos.easydoc.net/97788718/files/kzbh1yyg.png) - 添加常用参数 ![image.png](https://cos.easydoc.net/97788718/files/kzbh3aue.png) ## 3.项目 后端项目地址: 后端测试服务器地址: