使用须知

API 认证机制

用户可以通过两种方式与百度智能云进行交互,包括认证方式和匿名方式。对于认证方式,需要通过使用 Access Key Id / Secret Access Key 加密的方法来验证某个请求的发送者身份。Access Key Id(AK)用于标示用户,Secret Access Key(SK)是用户用于加密认证字符串和百度智能云用来验证认证字符串的密钥,其中 SK 必须保密,只有用户和百度智能云知道。

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

排版约定

排版格式 含义
< > 变量
[ ] 可选项
{ } 必选项
| 互斥关系
等宽字体 Courier New 屏幕输出

时间与日期

日期与时间的表示有多种方式。为统一起见,除非是约定俗成或者有相应规范的,凡需要日期时间表示的地方一律采用 UTC 时间,遵循 ISO 8601,并做以下约束:

  1. 表示日期一律采用 YYYY-MM-DD 方式,例如 2016-06-01 表示 2016年6月1日
  2. 表示时间一律采用 hh:mm:ss 方式,并在最后加一个大写字母 Z 表示 UTC 时间。例如23:00:10Z表示 UTC 时间 23点0分10秒。
  3. 凡涉及日期和时间合并表示时,在两者中间加大写字母 T,例如 2016-06-01T23:00:10Z 表示 UTC 时间2016年6月1日23点0分10秒