## 短鏈接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)