概述

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

回调实现

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

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

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

<?php   
$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来进行验证：

    <?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