概述

US3基本概念

在对象存储系统中，存储空间（Bucket）是文件（File）的组织管理单位，文件（File）是存储空间的逻辑存储单元。对于每个账号，该账号里存放的每个文件都有唯一的一对存储空间（Bucket）与键（Key）作为标识。我们可以把 Bucket 理解成一类文件的集合，Key 理解成文件名。由于每个 Bucket 需要配置和权限不同，每个账户里面会有多个 Bucket。在 US3 里面，Bucket 主要分为公有和私有两种，公有 Bucket 里面的文件可以对任何人开放，私有 Bucket 需要配置对应访问签名才能访问。

签名

本 SDK 接口是基于 HTTP 的，为了连接的安全性，US3 使用 HMAC SHA1 对每个连接进行签名校验。使用本 SDK 可以忽略签名相关的算法过程，只需要提供ufile_config所需的公私钥，然后使用 ufile_sdk_initialize 初始化SDK即可。 签名相关的算法与详细实现请见 Auth 模块

SDK源码和API文档

github 仓库

lib/api.h 里面是所有暴露出来的接口，每个接口的注释就是使用说明。 强烈建议您在使用前仔细阅读接口说明，以节省您的 debug 时间。

示例程序

源码example文件夹下提供了丰富的示例程序，具体如下：