API调用遵循HTTP协议，各Region采用不同的域名，具体域名为bts.{region}.baidubce.com。 数据交换格式为JSON，所有request/response body内容均采用UTF-8编码。

注意：使用API接口前，请根据用户实际情况进入“实名认证”页面进行“企业认证”或者“个人认证”，详细的操作步骤请参见实名认证。

API认证机制

所有API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成，均为字符串。 对于每个HTTP请求，使用下面所描述的算法生成一个认证字符串。提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}。

• version是正整数。
• timestamp是生成签名时的UTC时间。
• expirationPeriodInSeconds表示签名有效期限。
• signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号（;）分隔，如host;x-bce-date。列表按照字典序排列。（本API签名仅使用host和x-bce-date两个header）
• signature是256位签名的十六进制表示，由64个小写字母组成。

当百度智能云接收到用户的请求后，系统将使用相同的SK和同样的认证机制生成认证字符串，并与用户请求中包含的认证字符串进行比对。如果认证字符串相同，系统认为用户拥有指定的操作权限，并执行相关操作；如果认证字符串不同，系统将忽略该操作并返回错误码。

鉴权认证机制的详细内容请参见鉴权认证机制。

请求参数

请求参数包括如下4种：

返回值说明

返回值分为两种形式：

版本

直接定义在URL path中的首位，形如/v{version}，如/v1

资源层级

功能映射

说明

• URL路径中任意分隔符“/”支持任意数量连续，如/v1///instance等价于/v1/instance。
• URL路径中结尾的“/”，可有可无，即/v1/instance/等价于/v1/instance。

请求头域

响应头域

错误码

错误信息格式

当用户访问云数据库 TableStorage 出现错误时，会返回给用户相应的错误码和错误信息。 用户需要在访问异常时打印或记录返回的requestId和错误信息，便于用户定位问题，或者提工单。

系统返回错误信息格式如下：

{
    "code": "NoSuchKey",
    "message": "The resource you requested does not exist",
    "requestId": " 4db2b34d-654d-4d8a-b49b-3049ca786409"
}