Transcript z _api • Single Authentication flow for O365 • Azure AD Graph, Exchange, SharePoint • Device apps and web apps • Admin and.

z
_api
32
• Single Authentication flow for O365
• Azure AD Graph, Exchange, SharePoint
• Device apps and web apps
• Admin and end-user consent
• Secure protocol
• OAuth 2.0
• No capturing user credentials
• Fine-grained access scopes
• Supports MFA and federated user sign-in
• Long-term access through refresh tokens
Office 365 discovery services
Automatically determine URL of O365 services
Supports device app and website flows
Secured using Azure AD authentication
Serves information stored about services in AAD
Rich service metadata
Lists all Entities, Collections, Actions, Complex Types, Enums and
their Properties.
e.g: https://outlook.office365.com/api/v1.0/$metadata
Entity
Collection
Actions
Folder
Folders
CRUD, Copy, Move
Message
Messages
CRUD, Copy, Move, Reply, ReplyAll,
Forward, Send, CreateReply,
CreateReplyAll, CreateForward
Attachment
Attachments
CRUD
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$top=1
https://outlook.office365.com/api/v1.0/Me/SendMail/
Entity
Collection
Actions
CalendarGroup
CalendarGroups
CRUD
Calendar
Calendars
CRUD
Event
Events
CRUD, Accept, Decline, TentativelyAccept
CalendarView
N/A
Read
Attachment
Attachments
CRUD
https://outlook.office365.com/api/v1.0/Me/Calendar
https://outlook.office365.com/api/v1.0/Me/Calendar/Events?$top=1
https://outlook.office365.com/api/v1.0/Me/CalendarView?startDateTime=2014-10-01T01:01:01Z &
endDateTime=2014-11-01T01:01:01Z
Entity
Collection
ContactFolder
ContactFolders
Contact
Contacts
Actions
CRUD
https://outlook.office365.com/api/v1.0/Me/ContactFolders(‘Contacts’)/
https://outlook.office365.com/api/v1.0/Me/Contacts/
Entity
Collection
Drive
File
Folder
Actions
Read
Files
CRUD, Upload, Download
CRUD
https://contoso-my.sharepoint.com/_api/v1.0/me/drive
https://contoso-my.sharepoint.com/_api/v1.0/me/files
Entity
Collection
Actions
User
Users
CRUD
Groups
Groups
CRUD
https://graph.windows.net/contoso.com/users?api-version=1.5
 https://graph.windows.net/contoso.com/groups?api-version=1.5
Scenario
URL
Get 5 messages from Inbox
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$top=5
Get the next 10 messages
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$top=10&$skip=5
Get top 10 messages sorted by
DateTimeCreated
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$top=10&$orderby=DateT
imeCreated
Get selective properties on
messages
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$top=5&$select=From,Dat
eTimeCreated,Subject
Get events starting after a
particular DateTime
https://outlook.office365.com/api/v1.0/Me/Events?$top=5&$select=Subject,Start,End&$filter=S
tart ge 2014-09-22T20:00:00Z
Get Inbox messages with subject
and attachment info
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages?$format=application/json;
odata.metadata=none&$select=Subject&$expand=Attachments
Get # of messages with
attachment(s)
https://outlook.office365.com/api/v1.0/Me/Folders/Inbox/Messages/$count?$filter=HasAttach
ments eq true
Get count and selective props on
messages with attachment(s)
https://outlook.office365.com/v1.0/Me/Folders/Inbox/Messages?$format=application/json;odat
a.metadata=none&$select=Subject&$filter=HasAttachments%20eq%20true&$count=true
Get contact with a given name
https://outlook.office365.com/v1.0/Me/Contacts/?$filter=Givenname eq ‘John’
44
https://contoso-my.sharepoint.com/_api/v1.0/me/drive
summit.office.com
Developer Patterns & Practices
aka.ms/OfficeDevPnP
www.office.com/roadmap
http://aka.ms/OfficeDevFeedback
http://www.visualstudio.com
http://blogs.msdn.com/b/developer-tools/
http://msdn.microsoft.com/vstudio
http://channel9.msdn.com/Events/TechEd
www.microsoft.com/learning
http://microsoft.com/technet
http://developer.microsoft.com