## 短链接API >[info] 在创建推广链接的时候为了简洁好记，更多客户选择转化短链接 > 短链接有不同的API接口，草莓CDMS将接口功能集成到后台，设置短链接规则即可生效   ### 短链接API的接口方式 1、拼接接口地址（一般根据请求方式不同，提交需要转化的长地址和api-key） 2、请求API接口（get方式、post方式） 3、获得短链接返回值（txt直接返回、json返回） ### 接口规则 知道了上面的接口规则，就可以根据接口提供的方式写规则 ``` 替换符号：{#url} 对应 需要转换的二维码 请求方式|返回方式|接口地址|请求参数（post方法使用）|返回值接收方式（json返回值使用） ``` ### 设置接口规则方法 示例接口：[https://www.alapi.net/doc/show/16.html](https://www.alapi.net/doc/show/16.html)  >[info]可以短链接接口提供方，都会提供类似的接口文档 示例接口的请求方式支持get和post，并且提供了接口地址和参数名称、返回参数和格式 #### get请求方式 >[info] 根据上面的示例接口，使用get方式接口 ``` 由于是get接口，不需要设置规则的请求参数；规则如下： 请求方式|返回方式|接口地址|返回值接收方式 get|json|http://v1.alapi.cn/api/url?type=1&url={#url}|data,short_url ``` | 规则名称 | 设置内容 | 注解 | | --- | --- | --- | | 请求方式 | get | 接口文档提供了get和post，此处演示用的是get；根据接口实际情况填写 | | 返回方式 | json | 下文详细讲解 | | 接口地址 | http://v1.alapi.cn/api/url?type=1&url={#url} | 接口地址符合网址参数的拼接规则，接口文档要求请求参数包含url和type，type根据接口说明，设置1使用t.cn短网址；url设置长网址（用{#url}自动替换成生成时的长网址） | | 返回值接收方式 | data,short_url | 中间用英文逗号分割，表示取json返回值的`data->short_url`的内容 | #### post请求方式 >[info] 根据上面的示例接口，使用get方式接口 ``` 请求方式|返回方式|接口地址|请求参数（post方法使用）|返回值接收方式 post|json|http://v1.alapi.cn/api/url|{"type": "2","url": "{#url}"}|data,short_url ``` | 规则名称 | 设置内容 | 注解 | | --- | --- | --- | | 请求方式 | post | 接口文档提供了get和post，此处演示用的是get；根据接口实际情况填写 | | 返回方式 | json | 下文详细讲解 | | 接口地址 | http://v1.alapi.cn/api/url | 根据接口文档post方式无需在接口网址拼接参数 | | 请求参数 | {"type": "2","url": "{#url}"} | 需要提交type和url参数，使用json的格式，设置type为2（使用urlcn接口），url设置为{#url}自动替换成长网址 | | 返回值接收方式 | data,short_url | 中间用英文逗号分割，表示取json返回值的`data->short_url`的内容 | #### json返回方式  >[info] json返回方式，一般是带有长链接、短链接、成功、失败等内容 根据返回的内容，逐级写到最终短链接的地方 根据上面返回内容，可以看出来，short_url是最终的短链接 short_url 在data下面，data再往上就没东西了 那么应该设置为 `data,short_url` #### txt返回方式  >[info] txt返回方式，只有一段短链接的地址，没有任何其他返回 ``` 请求方式|返回方式|接口地址 get|txt|www.wx-url.cn/sina.php?url_long={#url} ``` 由于txt返回值不包含其他内容，所以不需要设置返回值的接受方式 #### 接口模拟测试工具 [https://www.sojson.com/http/test.html](https://www.sojson.com/http/test.html)