API:Shorturl/info


概览


Shorturl/info是 短网址 版本信息 API。

使用 shorturl/info API 可以获取您的短网址当前的版本信息、短网址/群组用量、和总访问量信息。



URL


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


支持格式


格式URL
jsonhttps://service.mysubmail.com/shorturl/info.json(默认)
xmlhttps://service.mysubmail.com/shorturl/info.xml


http 请求方式


请求方式content-type 设置
http postmultipart/form-datax-www-form-urlencodedapplication/json


是否需要授权


参阅 API 授权和验证机制


shorturl/info 请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的短网址应用ID
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal
参阅 API 授权与验证机制 > 授权和验证方式
signaturestring必需应用密匙 数字签名
参阅 API 授权与验证机制 > 授权和验证方式


代码示例


使用 CURL 方法获取版本信息


发送 CURL
curl -d 'appid=your_app_id&signature=your_app_key' https://service.mysubmail.com/shorturl/info.json


返回
{
    "status": "success",
    "info": {
        "level": "1", // 当前版本,0:免费版 ;1:基础版;2:高级版;3:企业版;4:旗舰版
        "max_shorturl": "500",         //当前版本最大短网址数量
        "max_shorturl_group": "100",         //当前版本最大群组数量
        "max_shorturl_customize_domain": "0",         //当前版本最大自定义域名数量
        "start_at": "2020-12-03 00:00:00",         //版本开始日期
        "expride_at": "2024-06-01 23:59:59",         //版本到期时间
        "current_used_shorturl_count": "31",         // 已使用的短网址数量
        "visit_at_this_month": "241",         //本月访量
        "visit_count": "11462",         // 全部访量
        "created_shorturl_count": "471",         //已创建的短网址总数
        "expired_shorturl_count": "399",         // 已过期的短网址总数
        "current_used_group_shorturl_count": 0,         // 已使用的群组短网址数量
        "created_group_shorturl_count": 0,         //已创建的群组短网址总数
        "expired_group_shorturl_count": 0,         // 已过期的群组短网址总数
        "current_used_group_count": 0      // 已使用的群组
    }
}


Info level 短网址版本信息描述


level : 0免费版
level : 1基础版
level : 2高级版
level : 3企业版
level : 4旗舰版


返回值


请求成功
{
      "status":"success",
            "info": {...}
}


请求失败
{
      "status":"error",
      "code":"1xx",
      "msg":"error message"
}


错误代码


参阅 API 错误代码