万维易源使用帮助手册

[TOC] 环境变量是易源API管理的强大功能,也是一大特色。环境变量有很多种用法,为API管理提供了极高的便利性。 ###环境变量的概念 环境变量是用户隔离的,也就是每一个用户有自己的一个全局命名空间,每个用户空间中的环境变量又分为三个子空间:生产环境、测试环境和草稿环境,如下图所示: ![](https://oss.showapi.com/doc/3105/176/3b46965fe4cb4ccfa0a3d00c040ca192.png) 每个变量对应三个值:生产、测试和草稿,三个值可以不同。在实际调用时,根据环境不同,易源会使用对应环境的变量值。 当然,如果您的接口数量有限,那么用不用环境变量是无所谓的。有参数变化时(比如后端服务器IP变化),可以一个一个改,可能还更快。但如果您上线了很多私有接口,几十个上百个,那一个IP改变需要改这么多接入点配置,那是不可以接受的。在这种情况下,使用变量就是最佳选择。 我们来看一下使用变量的示例,比如我们的后端服务地址如图: ![](https://oss.showapi.com/doc/3105/176/3f2a0f95cb3b44699173a95a5d494c8b.png) 其后端url为: ```html http://lua-app.showapi.com:990/httputil/showapitest ``` 为了防止IP和端口改变,那我们可以把上述调用url中嵌入变量,比如是: ```html http://{{showapi_env.my_ip}}:{{showapi_env.my_port}}/httputil/showapitest ``` 上面的语法是mustache语法。为什么要加一个showapi_env前缀呢?这是因为变量有2种: ```html 1.传入参数变量(这是动态变化的) 2.写死的环境变量(使用这种变量时,需要加上showapi_env前缀) ``` 至于第1种参数,那是从客户端输入中获取到的,比如客户端post过来一个参数post_ip,那我们就可以这样使用它: ```html http://{{post_ip}}:990/httputil/showapitest ``` 此post_ip参数是这样定义的: ![](https://oss.showapi.com/doc/3105/176/0fc6b447bee94390a4b4aeb0e01c4402.png) 这样就实现了后端服务的ip由前端传入参数来指定。当然通常我们不会这么干,因为ip一般是固定的,就算是有变化,也不需要由前端传入,因此我们用环境变量来定义ip即可。 回到之前说的: ```html http://{{showapi_env.my_ip}}:{{showapi_env.my_port}}/httputil/showapitest ``` 我们去哪里定义my_ip和my_port变量呢?请看下图: ![](https://oss.showapi.com/doc/3105/176/3efd5b75932d48b284fcd4369aa6f516.png) 之后在弹出界面做如下配置: ![](https://oss.showapi.com/doc/3105/176/f0e2e37ee87f4b2e978f1c754ff2e646.png) 同样的做法,我们来定义my_port参数: ![](https://oss.showapi.com/doc/3105/176/f0177dd979dd4cea936fbe352347ac48.png) 别忘记做保存提交操作。 ![](https://oss.showapi.com/doc/3105/176/9f8e328a36cb41ceb7d6c1ff5f7d65cb.png) 然后我们把后端地址改一下,用变量嵌入的形式: ![](https://oss.showapi.com/doc/3105/176/36aa3e5d67e443baa355543d785c235f.png) 保存接入点配置,去调试看一下: ![](https://oss.showapi.com/doc/3105/176/acd1ae59167c40f4a3318cb3b166b13b.png)