本教程旨在介绍如何使用七牛的Python SDK快速上传、下载、处理、管理等文件。

前言

上面两节我们了解到，客户端上传文件时，需要向业务服务器申请上传令牌（Upload Token），而这个上传令牌是业务服务器根据上传策略生成的（PutPolicy），并且在这个生成过程中还必须使用AccessKey和SecretKey。

从上面的简单图我们可以看出：

1. 上传客户端向业务服务器申请上传令牌（Upload Token）
2. 业务服务器返回上传凭证给上传客户端
3. 上传客户端构造上传请求，并将文件上传到七牛云存储服务器
4. 七牛云存储服务器返回客户端上传文件的结果。

当然，在我们前面的例子和后面的例子中，上传客户端和业务服务器是一个，但是从业务模型的角度来看，步骤1和步骤2仍然是分开的（比如在网页上上传或在移动应用程序）。

上传策略

如果我们想研究七牛的上传策略，就必须了解它支持的所有参数（总共不多）。文档：单击此处。
乍一看，很多人可能会觉得参数太多，让人不知所措。事实上，情况并非如此。处理太多的事情，最好的办法就是按照不同的功能将它们分组。例如，我们可以将上传策略分为以下几组：

基本参数

基本参数包括文件上传后的存储空间、文件上传方式（是否支持覆盖上传）、上传凭证的过期时间、业务服务器指定的上传文件名称等。

自定义上传回复

默认情况下，七牛云存储返回给上传客户端的信息只包含hash和key，正如我们之前看到的：

那么有什么办法可以扩展这个稀疏的返回信息呢？

答案当然是：可以！

上传完成的重定向

文件上传完成后，上传客户端从七牛云存储服务器获取上传结果的回复。在这个过程中，业务服务器没有参与，但是如果我想让七牛服务器在文件上传后告诉业务服务器一些信息呢？当然有可能。其中一种方法是页面重定向。当然，页面重定向需要知道重定向的地址（returnUrl）。另外，重定向到新地址携带的参数内容可以通过returnBody来设置。

文件上传完成后，七牛向上传者返回状态码303，然后上传者可以重定向到returnUrl指定的地址，例如重定向到http： //.../service/return_upload_service?upload_ret=eyJmbmFtZSI6InVwbG9hZF9kcmFmdC5wbmciLCJldGFnIjoiRnNOM0g4eS15NGxzcV9jZ2p0NEQ3a2E5cjVmUSIsImtleSI6IkZzTjNIOHkteTRsc3FfY2dqdDREN2th OX I1ZlEiLCJleFBhcmFtMSI6ImhlbGxvIiwiZXhQYXJhbTIiOiJxaW5pdSIsImV4UGFyYW0zIjoicWluaXUifQ==这样的地址，而这里returnUrl设置为http://.../service/return_upload_service，重定向地址携带的参数upload_ret的内容由returnBody指定。看起来upload_ret好像是base64编码，是的！是URL安全Base64编码（七牛应用中提到的base64编码一般都是URL安全Base64编码）。解码upload_ret以获取真实内容。

上传完成回调
上面我们看到了文件上传完成后七牛服务器和业务服务器进行交互的一种方式，这是通过上传侧的重定向来实现的。当然，这种方法是有适用场景的。但大多数情况下，我们七牛服务器和业务服务器之间的交互是采用另一种方式，称为回调。该回调发生在文件上传到七牛后。七牛会根据上传策略中参数callbackUrl指定的地址发送POST请求。请求的内容由上传策略中的指定。 CallbackBody由callbackHost指定，可用于指定回调的主机地址，例如IP地址。另外，callbackBody的内容组织格式为，由callbackBodyType决定。七牛服务器会根据callbackBodyType设置发送到业务服务器的POST请求的Content-Type。目前支持application/x-www-form-urlencoded和application/json这两种格式。

上传后触发持久化
我们知道七牛支持很多图像、音频、视频处理的接口和指令。假设我想从PC上上传一张图片或视频，然后在上传完成后立即触发七牛的文件处理指令。将上传的文件进行处理以支持不同平台上的文件，那么我可以使用以下三个参数。

文件上传限制
我们可以在上传策略中指定最大文件上传大小和允许的文件类型。