Office 365 报告 Web 服务返回的 HTTP 标头
Office 365 报告 Web 服务 返回到应用程序的某些信息以 HTTP 标头形式出现。本主题介绍这些标头及其使用方法。
上次修改时间： 2015年9月17日
适用范围： 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 |
此响应与之兼容的 ODATA DataServiceVersion。 |
X-RWS-Version:2013-V1 |
此响应与之兼容的 Office 365 服务版本标识符。 |
Content-Length:... |
应用程序可以使用此标头来确认已收到所有响应负载数据。 |
Content-Type:... |
应用程序可以使用此标头来确认 Web 服务已按请求的数据格式响应。 |
Date:... |
应用程序应在报告元数据中使用 <updated> 标记以显示报告生成的时间。 |
Set-Cookie:... |
请参阅 处理 X-BackEndCookie。 |
Pragma:no-cache |
应用程序通常可以忽略这些标头。报告应用程序通常不会缓存报告信息。相反，用户请求的更新会要求再次检索报告。 |
处理 X-BackEndCookie
Office 365 报告 Web 服务 可能会保留缓存的内部连接或状态信息。根据 RFC-2109 中的建议，HTTP 响应中服务器发送给应用程序的 Cookie 应由应用程序返回到后续请求中的系统。客户端应按照后续服务响应中的指示更新保留的 Cookie 信息。报告 Web 服务 返回名为 X-BackEndCookie 的 Cookie。您的应用程序应将该 Cookie 返回到后续请求中的服务器。