从 Outlook Office REST 获取联系人计数 API - Javascript

Question

我很难区分 Microsoft 大量荒谬的冲突 API 文档：outlook.office.com、outlook.office365.com、microsoft graph、Azure 等等

我已成功验证并提取联系人，但我似乎无法知道何时应该停止分页。

我一直在使用：

Access Token url: 
    https://login.microsoftonline.com/common/oauth2/v2.0/token;
Successful Contact url: 
    https://outlook.office.com/api/v2.0/me/contacts;

他们的 REST API Resource 说我应该能够简单地调用 https://outlook.office.com/api/v2.0/me/contacts/$count 但这会不断返回带有 body -1.[=24 的纯文本 MIME 类型=]

如果有人以前曾为此苦苦挣扎或知道发生了什么，我将不胜感激指出正确的方向 - 希望对您来说是一些简单的要点！

编辑：感谢下面的 Jason 的帮助支持。使用沙箱，我能够通过以下方式重现该问题：

登录到我的帐户 -> 收到访问令牌 -> 对 https://outlook.office.com/api/v2.0/me/contacts/$count

进行了 GET 调用

请求Headers:

GET https://outlook.office.com/api/v2.0/me/contacts/$count HTTP/1.1
Accept: text/*, application/xml, application/json; odata.metadata=none
User-Agent: PlayGroundAgent/1.0
Authorization: Bearer [standard-access-token]
client-request-id: 8f605[client-id-obscured-for-security]7289
X-AnchorMailbox: [email-address-removed-for-security on Whosebug]

回应

HTTP/1.1 200 OK
Transfer-Encoding: chunked
request-id: de95eaa8-95a7-40bb-b0f9-ced7270f0433
X-CalculatedBETarget: SN1PR05MB1998.namprd05.prod.outlook.com
X-BackEndHttpStatus: 200
OData-Version: 4.0
X-DiagInfo: SN1PR05MB1998
X-BEServer: SN1PR05MB1998
X-FEServer: SN1PR0501CA0035
X-MSEdge-Ref: Ref A: 657E0491C29D46978D8DD3B01B9F93A3 Ref B: DDDD64A109F4E842A8213F038BFDD5FA Ref C: Fri Aug 19 09:20:05 2016 PST
Cache-Control: private
Date: Fri, 19 Aug 2016 16:20:05 GMT
Set-Cookie: exchangecookie=6ca5fc4df96e458e8b879de61aa574ef; expires=Sat, 19-Aug-2017 16:20:05 GMT; path=/; HttpOnly
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET

-1

第二次编辑：它看起来像 https://outlook.office.com/api/v2.0/me/contacts?$count=true returns @odata.count": -1，即使它是 returns 的有效数组联系人。

第三次编辑：工作版本（与上述错误使用相同的方法） Url: https://outlook.office.com/api/v2.0/me/contacts/$计数

请求Headers:

GET https://outlook.office.com/api/v2.0/me/contacts/$count HTTP/1.1
Accept: text/*, application/xml, application/json; odata.metadata=none
User-Agent: PlayGroundAgent/1.0
Authorization: Bearer [access-token]
client-request-id: a7954db3-[client-id]-7a6e2e74dd9c
X-AnchorMailbox: [same-email-as-above]

响应：

HTTP/1.1 200 OK
Transfer-Encoding: chunked
request-id: 8c5db16b-3023-4968-9bdc-3d5ecac12ecb
X-CalculatedBETarget: SN1PR05MB1998.namprd05.prod.outlook.com
X-BackEndHttpStatus: 200
OData-Version: 4.0
X-DiagInfo: SN1PR05MB1998
X-BEServer: SN1PR05MB1998
X-FEServer: SN1PR0501CA0019
X-MSEdge-Ref: Ref A: 0574E46DB720491FBCEF23B73428F191 Ref B: FA4529229719F069B9D019E4D53E9200 Ref C: Fri Aug 19 09:42:55 2016 PST
Cache-Control: private
Date: Fri, 19 Aug 2016 16:42:55 GMT
Set-Cookie: exchangecookie=63a1de916a4c48be88569f05ce0361a7; expires=Sat, 19-Aug-2017 16:42:55 GMT; path=/; HttpOnly
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET

29

希望这些帮助！

Answer 1

得知您遇到问题，我们深感抱歉！这里发生了几件事。

令人不安的是，您从 $count 调用中得到一个负数。如果您转到 https://oauthplay.azurewebsites.net 并使用您的帐户登录，您会从那个电话中得到相同的结果吗？

对于分页来说，如果只想得到所有的结果，最好不要依赖$count这个值。相反，您应该使用响应中返回的 @odata.nextLink 值来获取下一页。当然，如果您试图在获得所有结果之前向用户指示有多少页，那么 $count 就是这样做的方法。

分页由页面大小（$top 参数）和 "cursor"（$skip parameter). If you're making a call to/me/contactswith no parameters, then you're getting the default page size of 10 and default cursor of 0. You can use the$top` 参数控制每页请求更多结果。

@odata.nextLink 值将始终 return 一个 URL，您可以根据您在 $top 中指定的页面大小（或 10，如果你没有指定）。这是 GET https://outlook.office.com/api/v2.0/me/contacts:

的价值

"@odata.nextLink": "https://outlook.office.com/api/v2.0/me/contacts/?%24skip=10"

这会跳过 10 个结果（基于默认页面大小 10）。

这是 GET https://outlook.office.com/api/v2.0/me/contacts/?$top=20 的值：

"@odata.nextLink": "https://outlook.office.com/api/v2.0/me/contacts/?%24top=20&%24skip=20"

如果没有更多页面，@odata.nextLink 值将不会出现在响应中。所以你可以用它作为停止分页的指标。

从 Outlook Office REST 获取联系人计数 API - Javascript

Getting a Count of Contacts from Outlook Office REST API - Javascript

javascript

msdn

outlook

outlook-restapi