区分大小写注意事项
本主题详细介绍了部分 OneDrive REST API 的区分大小写注意事项。
OneDrive URL
URL 方案和颁发机构(DNS 名称)不区分大小写。 URL 路径有的部分区分大小写,有的部分不区分大小写,具体视在寻址的资源类型而定。 请务必考虑本主题介绍的所有注意事项。
资源标识符
drive-id、item-id 等资源标识符区分大小写。
路径标识符
与冒号一起使用的文件系统路径标识符(如 :/Documents/MyFile.xlsx
)和 URL 中指定的文件名(如 /items/{item-id}/children/MyFile.xlsx
中的“MyFile.xlsx”)不区分大小写。
例如,路径 :/Folder-A/Foo.txt
和 :/folder-a/foo.TXT
是一样的。 同样,路径 /items/{item-id}/children/Foo.txt
和 /items/{item-id}/children/FOO.TxT
也是一样的。
元数据路径标识符(如“/items/{item-id}/image”)区分大小写。
查询参数
请求查询参数名称区分大小写。 例如,?select
和 ?SELECT
不一样。
请求标头
根据 HTTP 1.1 协议,请求头名称不区分大小写。 例如,Content-Type
和 content-type
是一样的。
请求头值区分大小写。
例如,在 if-match
头中提供 eTag 或 cTag 值时,标记区分大小写。
JSON 请求正文
请求正文中提供的 JSON 对象的键区分大小写。 名称/值对中提供的值按原样存储到服务中。
JSON 响应正文
在 JSON 响应中,属性名应采用 Camel 大小写格式。 返回的是 OneDrive 中存储的属性值(如项名称)。