Примечания касательно учета регистра символов

  • Статья

В этой статье подробно рассказывается о важности регистра символов для частей REST API OneDrive.

URL-адреса в OneDrive

При обработке схемы URL-адресов и центра (DNS-имени) учитывается регистр символов. Путь URL-адреса может состоять как из компонентов, для которых учитывается регистр символов, так и из компонентов, для которых регистр символов не учитывается. Это зависит от типа ресурса, к которому необходимо обратиться. Обязательно учитывайте все указанные в данной статье сведения.

Идентификаторы ресурсов

В идентификаторах ресурсов, например drive-id и item-id, регистр символов учитывается.

Идентификаторы пути

В идентификаторах путей в файловой системе, используемых с двоеточиями (например, :/Documents/MyFile.xlsx), и именах файлов, указываемых в URL-адресах (например, MyFile.xlsx в /items/{item-id}/children/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.

В значениях заголовков запросов регистр символов учитывается. Например, при указании значения eTag или cTag в заголовке if-match в теге учитывается регистр символов.

Тело запроса JSON

В ключах объекта JSON, передаваемых в теле запроса, необходимо учитывать регистр символов. Значения, указываемые в парах имя-значение, сохраняются в службе в неизменном виде.

Текст ответа JSON

В ответе JSON в именах свойств поочередно используются прописные и строчные буквы. Значение свойства (например, имя элемента) возвращается в том виде, в котором оно хранится в OneDrive.