Заголовки HTTP, возвращаемый веб-службой отчетов Office 365

Некоторые сведения, Веб-служба отчетов Office 365 возвращает приложению, поступающие в виде заголовки HTTP. В этом разделе описываются эти заголовки и как их использовать.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Пример

Следующие заголовки были возвращены из MailFilterList запроса.

Pragma:no-cache
request-id:07233171-c795-470f-bf09-0fb8ea028841
X-CalculatedBETarget:by2pr03mb027.namprd03.prod.outlook.com
X-Content-Type-Options:nosniff
DataServiceVersion:2.0;
X-RWS-Version:2013-V1
X-DiagInfo:BY2PR03MB027
X-BEServer:BY2PR03MB027
X-UA-Compatible:IE=10
X-FEServer:BY2PR03CA011
Content-Length:42266
Cache-Control:no-cache, no-store
Content-Type:application/atom+xml;type=feed;charset=utf-8
Date:Sun, 10 Feb 2013 19:50:25 GMT
Expires:-1
Set-Cookie:X-BackEndCookie=S-1-5-21-2412119505-3560892057-1500426294-2779018=u56Lnp2ejJqBnM+Zy8jInpzSncjKzdLLmsfP0p6ZmcfSzMycysiems+ax53PgZqHkJuakpDO0ZCRkpacjZCMkJmL0ZyQkoHN0M7P0M3Pzszfx8XPz8XNyt+vsg==; expires=Sun, 10-Feb-2013 20:00:25 GMT; path=/ecp/reportingwebservice; secure; HttpOnly
Server:Microsoft-IIS/7.5
X-AspNet-Version:4.0.30319
X-Powered-By:ASP.NET

Следующей таблице приведены сведения о заголовках и как приложение их обработки.

Возвращенный заголовки HTTP

Имя заголовка

Руководство по обработке

request-id:...

Идентификатор GUID определяет запрос, который ваше приложение. Служба поддержки клиентов может потребоваться для помощи в устранении неполадок в службе. Приложения не необходимости выполнять любые действия с ним.

DataServiceVersion:2.0

DataServiceVersion ODATA, совместимый с этой ответа.

X-RWS-Version:2013-V1

Идентификатор версии службы Office 365, совместимый с этой ответа.

Content-Length:...

Приложения могут использовать это, чтобы убедиться, что все данные полезных данных ответ был получен.

Content-Type:...

Приложения могут использовать это, чтобы убедиться, что веб-службы были получены в формате запрошенные данные.

Date:...

Приложения должны использовать < обновленные > тег в метаданные отчетов будет отображаться, если был создан отчет.

Set-Cookie:...

См Обработка X-BackEndCookie.

Pragma:no-cache
X-CalculatedBETarget:...
X-Content-Type-Options:nosniff
X-DiagInfo...
X-BEServer:...
X-UA-Compatible:
X-FEServer:...
Cache-control:...
Expires:-1
Server:...
X-AspNet-Version:...
X-Powered-By:...

Приложение обычно можно игнорировать их. Обычно отчетов приложений следует кэшировать данные отчета. Вместо этого обновления затребованы вызовов пользователей для получения отчета еще раз.

Обработка X-BackEndCookie

Веб-служба отчетов Office 365 могут сохранять кэшированные внутреннее соединение или сведения о состоянии. В соответствии с рекомендациями в RFC 2109файлы cookie, отправленные в приложение с сервера в HTTP-ответа, могут быть возвращены приложения в систему в последующие запросы. Клиент следует обновить сведения сохраненный файл cookie, как указано в последующие ответы. Веб-служба отчетов возвращает файл cookie с именем X-BackEndCookie. Приложения должна вернуть этот файл на сервер в последующие запросы.