性能魔方系统文档

功能说明

本服务的主要功能为:为用户提供CDN日志下载开放API接口,用户可以通过调用API查看查询对应时间范围内日志记录,下载对应时间范围内的日志文件。

API使用说明

本服务提供了Web API接口,开发者可以使用自己熟悉的语言,在Web应用或者客户端程序中方便的调用。下面具体介绍下服务的调用方法及样例:

申请API Token

登陆 http://www.mmtrix.com 并注册账号,在“个人中心”的“接口管理”中生成服务accesskey和securekey。

api使用方法

查看日志清单

http请求路径

http://access_log.mmtrix.com/log/:domain

http请求方法

GET

参数名 含义
domain 要查询cdn日志的域名
start 开始时间
end 结束时间
ak 申请到的accesskey
sign accesskey,start,end,securekey参数按字母顺序连接后的md5值
http返回内容

请求返回内容为JSON,未通过身份认证和频率控制的返回格式如下:

{
    "code": 1,                  //返回状态码
    "msg": ""                   //返回错误消息
}
状态码对应表
状态码 含义
1 参数丢失
2 身份认证失败
3 accesskey不存在
4 域名与身份不匹配
5 不存在此域名的cdn日志
99999 API调用次数超过限额

正确返回格式如下:

{
    "token": "",                //返回状态
    "logs": [                   //日志详细
              {
                  "filename":"",//日志文件名
                  "size":1024,  //日志文件大小
                  "url":"",     //日志文件下载路径
                  "start":"",   //日志文件开始时间
                  "end":""      //日志文件结束时间
              },
              ...
            ]                   
}
样例

curl版本

http请求

#!/bin/bash
URL="http://access_log.mmtrix.com/log/"
AK="fe8dc959e7f9fa5de6dab87bb9b7d8ca"
DOMAIN="www.mmtrix.com"
SK="e5828c564f71fea3a12dde8bd5d27063"
START="20150907"
END="20150914"
MD5=`echo -n "ak=${AK}&end=${END}&sk=${SK}&start=${START}"|md5sum|awk '{print $1}'` 
curl "${URL}${DOMAIN}?ak=${AK}&end=${END}&start=${START}&sign=${MD5}"
exit $?

http返回

{
       "token": "84e1e7fb609cc5fd0359ed1b244fa1db",                   
       "logs":[
            {
                "filename":"access_log.gz_2015090700",
                "size":721562,
                "url":"http://access_log.mmtrix.com/data/www.mmtrix.com/access_log.gz_2015090700",
                "start":"2015090700",
                "end":"2015090702"
            },
            ...
       ]          
}

下载日志文件

http请求路径

http://access_log.mmtrix.com/data/:domain/:filename

http请求方法

GET

参数名 含义
domain 要下载日志的域名
filename 下载日志的文件名
token 下载日志的token,由上一个API获取
HTTP状态码对应表
状态码 含义
200 下载成功
403 token错误/下载次数超过限额(一个token最多可下载200次日志)/未找到对应cdn日志下载任务域名
404 未带正确参数
500 内部错误
样例
curl版本

http请求
```shell
#!/bin/bash
URL="http://access_log.mmtrix.com/data/"
DOMAIN="www.mmtrix.com"
FILENAME="access_log.gz_2015090700"
TOKEN="84e1e7fb609cc5fd0359ed1b244fa1db"
curl "${URL}${DOMAIN}/${FILENAME}?token=${TOKEN}" 
exit $?