API: ShortURL/Group - 短网址群组

概览

shorturl/group是 SUBMAIL 的短网址群组 API。

使用 shorturl/group API 可以获取、创建、编辑或删除您的短网址群组。

shorturl/group` API 使用 HTTP 规范中的 GET, POST, PUT, DELETE 方法对短网址群组进行操作，使用 GET 方法获取单个或全部短网址群组、POST 方法创建新的短网址群组、PUT 方法更新或编辑一个短网址群组，或使用 DELETE` 方法删除一个短网址群组。

URL

<主>https://service.mysubmail.com/shorturl/group

支持格式

http 请求方式

是否需要授权

是

参阅 API 授权和验证机制

shorturl/group GET 方法（获取短网址群组）请求参数

shorturl/group POST 方法（创建短链接群组）请求参数

shorturl/group PUT 方法（更新短链接群组）请求参数

shorturl/group DELETE 方法（删除短链接群组）请求参数

代码示例

使用 CURL GET方法获取短网址列表

发送 CURL

curl -s "https://service.mysubmail.com/shorturl/group.json?appid=your_appid&signature=your_appkey"

返回

{
    "status": "success",
    "groups": [
        {
            "group": "09ae64b7adbfe917f58e5ddd5200915",
            "name": "submailTest",
            "create_at": "2019-07-17 07:24:28"
        }
    ]
}

使用 CURL POST方法提交短网址群组

发送 CURL

curl -d "appid=your_appid&signature=your_appkey&name=submail"。https://service.mysubmail.com/shorturl/group.json

返回

{
    "status": "success",
    "group": "3c6a3e194526c5dd4cd3378ad6a7b4"
}

使用 CURL PUT 方法修改短网址群组

发送 CURL

curl --data "appid=your_appid&signature=your_appkey&name=submailgroup=3c6a3e194526cdd4cd3378ad6a7b4" -X put https://service.mysubmail.com/shorturl/group.json

返回

{
    "status":"success"
}

使用 CURL DELETE 方法删除短网址群组

发送 CURL

curl --data "appid=your_appid&signature=your_appkey&group=3c6a3e194526cdd4cd3378ad6a7b4" -X delete  https://service.mysubmail.com/shorturl/group.json

返回

{
    "status":"success"
}

返回值

请求成功

{
      "status":"success"
}

请求失败

{
      "status":"error",
      "code":"1xx",
      "msg":"error message"
}

错误代码

参阅 API 错误代码