自制了一个 API 返回一些随机媒体文件。
暂时不对外开放,记录一下参数,备忘。
Endpoint 请求地址:
https://dpop.top/api/
*纯ipv6,不支持ipv4
Parameters 参数:
- key (必填)
- type (选填,获取媒体的类型,默认为混合图/音/视)
- dir(选填,默认为根目录)
- encode(可选,默认json输出)
key
string 密钥,鉴权用,当密钥错误则无法获取
dir
string 子目录路径,将会包含此目录下的所有子目录及子目录内所有目录和文件。
- 根目录(默认)
- [子目录]%2f[子目录]%2f[子目录]
type
string 媒体类型
- 获取所有图/音/视文件 (默认)
- image 只获取图片
- video 只获取视频
- audio 只获取音频
留空时不会获取除图音视以外的其他文件类型。
encode
string 输出格式
输出类型,取值如下
- json (默认)
- text 输出纯文本的url
- block 输出对应html代码
- file 直接跳转url对应的文件
输出
code
状态码,取值如下:
msg
状态信息,通常会有以下几种:
- Nothing returned. 啥也没找到
- Invalid dir path 错误的路径(路径无法访问)
- Error 错误
- You have to provide a vialed key. 必须提供一个密钥(当密钥参数为空)
- Unknown file type 文件类型未知
- Wrong key 密钥错误
- Unauthorized 未授权
- Success 成功
url
媒体文件的链接
ext
媒体文件的扩展名,输出如 “jpg”/”mp4″/”mp3″等
便于判断媒体类型。
举个栗子
https://dpop.top/api/?key=123&dir=travel&type=image&encode=json
将随机以json格式输出一张 在”travel” 目录下的图片:
{
"code": 2,
"msg": "success",
"url": "https:\/\/dpop.top\/lib\/travel\/20222\/IMG_0641.JPG",
"ext": "jpg"
}
#api