Introduction to Office365 API

• Office 365 Components• Office 365 API• Authentication• Discovery• API

• Office 365 Unified API

Agenda

Office 365 components

Tenant A

Applications

Principal Manageme

nt

Custom Applications

Office 365 components

Challenges … • Prompt for credentials • Couldn’t discover content automatically

Office 365 API

What is Office 365 API?• Set of REST APIs enable you to provide access to

Office 365 data, including mail, calendars, contacts, users and groups, files, and folders within our app

Office 365 API

Authentication• Azure active directory OAuth in Office 365• Ability from custom applications to have single

authentication flow to access all O365 APIs like• Azure ad• Exchange• SharePoint , etc..

Office 365 API

Authentication - Actors• Custom Application• Azure AD authorization endpoint• The webpage that tells user to authorize app access. Returns

authorization code

• Azure AD token endpoint• App gets the access token. Returns access token and a multi resource

refresh token

• Office 365 API

Office 365 API

Discovery Services• Based on the access token, app can ask office 365

what are the resources it can access• Client doesn’t require to type in long addresses

Office 365 API

API

Office 365 API

Sites Lists

Taxonomy

Workflow

Search

Active Directory

Exchange & Outlook

SharePoint

API – Files• File• Folder• Drive

• Samples• https://<sharepoint>/_api/v1.0/me/files• https://<sharepoint>/_api/v1.0/me/files/getByPath(“foldername/file”)

Office 365 API

API – Calendar• CalendarGroup• Calendar• Event• Attachment

• Samples• https://outlook.office365.com/api/v1.0/me/calendars• https://outlook.office365.com/api/v1.0/me/events

Office 365 API

API – Mail• Folder• Message• Attachment

• Samples• https://outlook.office365.com/api/v1.0/me/folders/inbox/messages• https://outlook.office365.com/api/v1.0/me/folders/inbox/sendMail

Office 365 API

API – Contacts• ContactFolder• Contact

• Samples• https://outlook.office365.com/api/v1.0/me/contacts

Office 365 API

API – OneDrive

Samples• https://<onedrive>/_api/v1.0/me/files

Office 365 API

SDKs

Office 365 API

• Exposes multiple APIs from Microsoft cloud services through a single REST API endpoint

• Still in beta

Office 365 Unified API

• Samples• https://graph.microsoft.com/<version>/<tenant>/contacts• https://graph.microsoft.com/<version>/<tenant>/groups• https://graph.microsoft.com/<version>/me/files?$filter=name+ne+'mySecret'&$

select=id,name,webUrl

Office 365 Unified API

Thank You !