开发文档 - 先锋电竞网络oss

📌 接口基础信息

请求方式： POST multipart/form-data

返回格式： JSON（默认）、JSONP、FORM

跨域支持： ✅ 支持Web跨域调用、程序直接调用

错误示例：

{"code":-100,"msg":"缺少 AccessKey 或 SecretKey"}

📤 请求参数说明

字段名	变量名	是否必填	示例值	描述
文件	file	是	-	multipart格式文件
AccessKey	AccessKey	是	AK_xxxxxx	用户实例身份标识
SecretKey	SecretKey	是	SK_xxxxxx	用户实例密钥
是否首页显示	show	否	1	默认为是
是否设置密码	ispwd	否	0	默认为否
下载密码	pwd	否	123456	默认留空
返回格式	format	否	json	json、jsonp、form
跳转url	backurl	否	http://	仅form有效
回调	callback	否	callback	仅jsonp有效

📥 返回参数说明

字段名	变量名	类型	示例值	描述
上传状态	code	Int	0	0成功，其他失败
提示信息	msg	String	上传成功！	错误提示
文件MD5	hash	String	f1e807cb...	文件唯一标识
文件名称	name	String	test.jpg	原始文件名
文件大小	size	Int	58937	字节
文件格式	type	String	jpg	后缀
下载地址	downurl	String	http://	下载地址
预览地址	viewurl	String	http://	仅音视频图片

💻 调用示例（PHP）

PHP 示例：

<?php
$apiUrl = "https://oss-cn6.ossxfdjwl.cn/api.php";
$postData = [
    "AccessKey" => "AK_xxxxxx",
    "SecretKey" => "SK_xxxxxx",
    "show" => 1,
    "ispwd" => 0,
    "format" => "json"
];
$filePath = "test.jpg";
$file = new CURLFile(realpath($filePath));

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array_merge($postData, ["file" => $file]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result["code"] == 0) {
    echo "上传成功：" . $result["downurl"];
} else {
    echo "失败：" . $result["msg"];
}
?>

成功返回：

{
  "code": 0,
  "msg": "上传成功！",
  "hash": "f1e807cb0d6ba52d71bdb02864e6bda8",
  "name": "example.jpg",
  "size": 58937,
  "type": "jpg",
  "downurl": "http://oss-cn6.ossxfdjwl.cn/xxx.jpg",
  "viewurl": "http://oss-cn6.ossxfdjwl.cn/xxx.jpg"
}

上传API开发文档

📌 接口基础信息

📤 请求参数说明

📥 返回参数说明

💻 调用示例（PHP）

开始对接你的开发项目