本服务的主要功能为:为用户提供CDN日志下载开放API接口,用户可以通过调用API查看查询对应时间范围内日志记录,下载对应时间范围内的日志文件。
本服务提供了Web API接口,开发者可以使用自己熟悉的语言,在Web应用或者客户端程序中方便的调用。下面具体介绍下服务的调用方法及样例:
登陆 http://www.mmtrix.com 并注册账号,在“个人中心”的“接口管理”中生成服务accesskey和securekey。
http://access_log.mmtrix.com/log/:domain
GET
参数名 | 含义 |
---|---|
domain | 要查询cdn日志的域名 |
start | 开始时间 |
end | 结束时间 |
ak | 申请到的accesskey |
sign | accesskey,start,end,securekey参数按字母顺序连接后的md5值 |
请求返回内容为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://access_log.mmtrix.com/data/:domain/:filename
GET
参数名 | 含义 |
---|---|
domain | 要下载日志的域名 |
filename | 下载日志的文件名 |
token | 下载日志的token,由上一个API获取 |
状态码 | 含义 |
---|---|
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 $?