概述

客户上传文件到七牛后，七牛服务器会响应 200 状态码，响应内容包括 hash 和 key 。但是如果客户需要自定义响应内容，则可以通过设置回调来实现。

回调实现

客户端需要在上传 token 中设置 callbackurl 和 callbody

1、callbackurl 必须是公网上可正常进行 POST 请求并能正常响应的 url，并且业务服务器返回给七牛的内容必须是 json 串.

这里给一个最简单的能响应200的php代码(获取 callbackbody 并打印一个字符串给客户端)

$notifyBody = file_get_contents('php://input');

file_put_contents("test.txt",$notifyBody);

$arr=array("date"=>"test");

echo json_ encode($arr);

?>

2、callbackbody 是需要向业务服务器发送的回调内容，需使用七牛的魔法变量或自定义变量来填充。

但是格式一定要正确，否则会报400格式错误.

例如 java 中正确的格式：

auth.uploadToken(bucket,key,3600,new StringMap()

.put("callbackUrl","callbackurl")

.put("callbackBody", "{"filename":$(fname),"filesize":$(fsize),"width":$(imageInfo.width)}") );

3、callbodytype 默认是 application/x-www-form-urlencoded, 也可在上传策略中设置为 application/json

回调鉴权

因为回调地址是公网可访问的，任何一台服务器都可以对其发起回调，如何确认回调是来自七牛的呢？

七牛在发起回调请求时会在请求头中带上 Authorization 字段，

Authorization:QBox iN7NgwM31j4-BZacMjPrOQBs34UG1maYCAQmhdCV:tDK-3f5xF3SJYEAwsll5g=

其中 QBox 为固定值，iN7Ngw...dCV 为用户的 Accesskey，tDK-3f...5g= 为签名结果 encoded_data。

业务服务器可以通过多种方法来对其进行验证， 例如如下面的代码php来进行验证：

require_once __DIR__ . '/../autoload.php';

use Qiniu\Auth;

$accessKey = getenv('QINIU_ACCESS_KEY');

$secretKey = getenv('QINIU_SECRET_KEY');

$bucket = getenv('QINIU_TEST_BUCKET');

$auth = new Auth($accessKey, $secretKey);

//获取回调的body信息

$callbackBody = file_get_contents('php://input');

//回调的contentType

$contentType = 'application/x-www-form-urlencoded';

//回调的签名信息，可以验证该回调是否来自存储服务

$authorization = $_SERVER['HTTP_AUTHORIZATION'];

//回调url

$url = 'http://172.30.251.210/upload_verify_callback.php';

$isQiniuCallback = $auth->verifyCallback($contentType, $authorization, $url, $callbackBody);

if ($isQiniuCallback) {

$resp = array('ret' => 'success');

} else {

$resp = array('ret' => 'failed');

}

echo json_encode($resp);

回调常见错误

1、400错误

这个是上传时表单格式错误，例如 callbackbody 设置的格式有问题等

2、579错误

1、上传成功回调失败，可以自己先用curl来验证callbackurl是否能成功响应200

curl -X POST -d "name=123.jpg" http://url

2、业务服务器返回给七牛的 body 不是合法的 json 串

报错信息：{"error":"unexcepted response"}

这时可通过抓包，获取七牛返回给客户端的 body ，通过 http://jsonlint.com 验证是否回调的 body 为合法的 json 串

3、业务服务器拒绝七牛的回调请求

解决方案是配置允许七牛的回调UA的访问。 七牛回调UA：qiniu-callback/1.0