* API网关/apikey/apisecret 请在后台查看菜单【API接口】
* 所有接口都采用 HTTPS POST 方式调用。
* 所有字段字符编码采用utf-8。
* 所有接口都需要传 apikey/apisecret 参数做身份验证。
*****
所有接口说明:
| 接口名 | 描述 | 是否扣金币 |
| --- | --- | --- |
| add | 添加单个链接 | **扣金币** |
| adds | 批量添加链接 | **扣金币** |
| remove| 删除链接 | 免费 |
| update| 更新链接 | 免费 |
| info| 链接详细信息 | 免费 |
| list| 获取链接列表 | 免费 |
接口返回值统一说明:
| 字段 | 说明 | 值 |
| --- | --- | --- |
| result | 状态值 | 0:成功 <0:负数都为失败 |
| message | 消息 | 成功时为“ok”,失败时为错误消息 |
| data | 数据 | 仅当result=0时才返回json数据 |
全局错误码:
| 错误码 | 解释 |
| --- | --- |
| -100 | 接口不存在 |
| -101 | 没有传 ?apikey=xxx&apisecret=xxx 的参数或值为空|
| -102 | POST没有发送json数据|
| -103 | POST json数据有误|
| -104 | apikey或apisecret不存在|
| -105 | 链接非法|
| -200 | 帐户金币不足|
完整的接口示例和返回值:
`Linux: curl -X POST -d '{"link":"http://3url.cn","info":"短链二维码服务平台"}' "<API网关>/apis/add?apikey=xxxx&apisecret=xxxx"`
```
{"result":0,"message":"ok","data":{"short_key":"B1eC32","shorturl":"https:\/\/t4a.cn\/B1eC32"}}
```