go-fastdfs/doc/api.md
2019-07-25 17:23:29 +08:00

111 lines
2.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## API通用说明
```
一、统一使用POST请求
二、返回格式统一为json
  格式如下
{
"status":"ok",
"message":"",
"data":{}
}
二、url中的group只有在support_group_manage设置为true才有。
例如:
http://10.1.5.9:8080/group/reload
默认:
http://10.1.5.9:8080/reload
说明url中的group为cfg.json中的group参数值。
```
## 配置管理API
```
http://10.1.5.9:8080/group/reload
参数:
action: set(修改参数),get获取参数,reload重新加载参数
cfg:json参数 与 action=set配合完成参数设置
```
## 文件统计信息API
```
http://10.1.50.90:8080/group/stat
```
## 文件上传API
```
http://10.1.50.90:8080/group/upload
参数:
file:上传的文件
scene:场景
output:输出
path:自定义路径
具体请参阅示例代码用浏览器访问http://127.0.0.1:8080
```
## 文件秒传
```
http://10.1.50.90:8080/group/upload
参数:
md5:文件的摘要
摘要算法要与cfg.json中配置的一样
例子http://127.0.0.1:8080/upload?md5=430a71f5c5e093a105452819cc48cc9c&output=json
```
## 文件删除
```
http://10.1.50.90:8080/group/delete
参数:
md5:文件的摘要md5|sha1 视配置定
path:文件路径
md5与path二选一
说明md5或path都是上传文件时返回的信息要以json方式返回才能看到参阅浏览器上传
http://127.0.0.1:8080/delete?md5=430a71f5c5e093a105452819cc48cc9c
```
## 文件信息
```
http://10.1.50.90:8080/group/get_file_info
参数:
md5:文件的摘要md5|sha1 视配置定
path:文件路径
md5与path二选一
说明md5或path都是上传文件时返回的信息要以json方式返回才能看到参阅浏览器上传
例子http://127.0.0.1:8080/get_file_info?md5=430a71f5c5e093a105452819cc48cc9c
```
## 文件列表
```
http://10.1.50.90:8080/group/list_dir
参数:
dir要查看文件列表的目录名
例子http://127.0.0.1:8080/list_dir?dir=default
```
## 修复统计信息
```
http://10.1.50.90:8080/group/repair_stat
参数:
date:要修复的日期格式如20190725
例子http://127.0.0.1:8080/repair_stat?date=20190725
```
## 同步失败修复
```
http://10.1.50.90:8080/group/repair
参数:
force:是否强行修复(0|1)
例子http://127.0.0.1:8080/repair?force=1
```
## 从文件目录中修复元数据(性能较差)
```
http://10.1.50.90:8080/group/repair_fileinfo
需要开启搬迁功能修改cfg.json配置文件中的 enable_migrate 设为true
```