Microsoft just released OneNote for Mac today. They also made OneNote for PC free, which means there's a free OneNote app on Windows, Windows Phone, iOS, Mac, Android and a really full featured HTML5 web version at http://www.office.com. This is all very cool of course, but I'm interested in the APIs.
微软今天刚刚发布了Mac版OneNote 。 他们还免费提供了适用于PC的OneNote,这意味着Windows,Windows Phone,iOS,Mac,Android上有一个免费的OneNote应用程序,以及位于http://www.office.com的功能齐全HTML5网络版本。 这当然很酷,但是我对API感兴趣。
Now, to be clear, I have worked for Microsoft for the last few years on ASP.NET and Azure, but I don't know anyone in the Office team. I am not privy to any secret info and I get most of my news from The Verge, just like you.
现在,要明确地说,我过去几年在Microsoft工作于ASP.NET和Azure,但我不认识Office团队中的任何人。 我不了解任何秘密信息,就像您一样,我从The Verge获得了大部分新闻。
But from my perspective, the real story here is that Microsoft has woken up to the power of the API. Some may argue that they've always had powerful web APIs, which is true, however the breadth and scope of these APIs and their ubiquity seems to have accelerated in recent years. They are clearer, more open, simpler, and more cross-platform than ever before.
但是从我的角度来看,这里的真实故事是Microsoft唤醒了API的功能。 有人可能会争辩说,他们一直拥有强大的Web API,这是事实,但是近年来,这些API的广度和范围以及它们的普遍性似乎在加速。 它们比以往任何时候都更加清晰,开放,简单和跨平台。
The Azure cloud and the Azure HTML5 Portal where folks manage their apps uses a REST API, and the SDKs to use them - as well as a cross platform nodejs command line application - are on GitHub. If you use the main portal, write your own, or use Visual Studio, it all calls the same open API. Duh.
人们在其上管理其应用的Azure云和Azure HTML5门户使用REST API,并且使用它们的SDK和跨平台的nodejs命令行应用程序位于GitHub上。 如果您使用主门户网站,编写自己的门户网站或使用Visual Studio,则它们都将调用相同的开放API。 咄。
Exchange has APIs, Microsoft IDs use OAuth, Azure's Portal has an API and uses it themselves, SharePoint is one giant REST/OData API, Office 365 has been quietly releasing APIs for Mail, Calendar, and Contacts, and even now Lync has a REST Web API now.
Exchange具有API,Microsoft ID使用OAuth,Azure的Portal具有API并自行使用,SharePoint是一个庞大的REST / OData API, Office 365一直在悄悄发布用于邮件,日历和联系人的API ,甚至现在Lync也具有REST Web API现在。
Today when the Office team launched OneNote for Mac, they also launched http://dev.onenote.com along with integration partners like Feedly, JotNot, IFTTT, Weave News Reader and more all integrating with their REST API.
今天,当Office团队启动Mac版OneNote时,他们还与Feedly,JotNot,IFTTT,Weave News Reader等集成合作伙伴一起启动了http://dev.onenote.com ,并且所有这些都与他们的REST API集成在一起。
The moral of the story here is - if you have no API then you have no story.
这个故事的寓意是-如果您没有API,那么您就没有故事。
使用OneNote API (Using the OneNote API)
There's even more evidence of a change in thinking inside the big house. It's clearly of note that the API example in the OneNote API documentation on MSDN used Objective-C. They also link to a OneNote interactive Console at Apigee.
有更多证据表明,大房子内部的思维发生了变化。 值得注意的是,MSDN上的OneNote API文档中的API示例使用了Objective-C 。 它们还链接到Apigee的OneNote交互式控制台。
The API appears to be basically RESTful, with a POST of HTML to https://www.onenote.com/api/v1.0/pages creating a new OneNote page in your authenticated notebook.
该API看起来基本上是RESTful的,带有HTML的POST到https://www.onenote.com/api/v1.0/pages,并在经过身份验证的笔记本中创建新的OneNote页面。
You authenticate with your Microsoft ID using the SDK, get the token from the SDK object to be used in the authentication header then POST.
您使用SDK使用Microsoft ID进行身份验证,从SDK对象中获取令牌,以在身份验证标头中使用令牌,然后进行POST。
What has surprised me is that they have tutorials and samples across all platforms:
让我感到惊讶的是,他们在所有平台上都有教程和示例:
Android - Create an Android capture app - OneNoteServiceSamplesAndroid
Windows Phone - …a Windows Phone capture app - OneNoteServiceSamplesWinPhone
Windows Phone- …Windows Phone捕获应用程序-OneNoteServiceSamplesWinPhone
Windows Store - …a Windows Modern UI capture app - OneNoteServiceSamplesWinStore
Windows Store- …一个Windows Modern UI捕获应用程序-OneNoteServiceSamplesWinStore
REST - Use the apigee.com API console - Open the interactive console
REST-使用apigee.com API控制台-打开交互式控制台
And, heck, the samples are all on GitHub too: https://github.com/OneNoteDev.
而且,这些示例也都在GitHub上: https : //github.com/OneNoteDev 。
It looks like the focus for this initial launch is POST/Create for capture apps, photos, text, clippers, etc, but all the verbs are coming, clearly at the top of their backlog.
最初启动的焦点似乎是POST / Create,用于捕获应用程序,照片,文本,Clipper等,但是所有动词都即将出现,显然在待办事项的顶部。
I like this direction, and to me, it's representative of a larger shift to recognize that the world doesn't always run Windows. I've said it before, and I'll said it again - The Web will always win.
我喜欢这个方向,对我来说,它代表了一个更大的转变,即认识到世界并非总是运行Windows。 我已经说过了,我会再说一遍-网络将永远赢。
相关链接 (Related Links)
翻译自: https://www.hanselman.com/blog/onenote-and-microsofts-quiet-api-revolution