The OneNote REST API Explorer for iOS explores the simple REST calls that access, add, update, and delete OneNote entities such as notebooks, section groups, sections, and pages. The app lets you authenticate against an Office 365 tenant and perform standard operations against the OneNote service in O365.

This sample includes the following operations for enterprise OneNote:

* Get a list of your noteobooks

* Get metadata of a section

* Post a page with a snapshot of a web page

* post a page with business card image text

* Post a page with extracted web page text

**Note:** Currently this sample does not support MSA authentication with accounts such as outlook.com or a live account. This functionality will be included in future updates.

Once you have an Office 365 account, an Azure AD account that is bound to your Office 365 Developer site, you'll need to perform the following steps:

Note: If you've never used CocoaPods before as a dependency manager you'll have to install it prior to getting the dependencies into your project. If you already have it installed you may skip this installation step and move on to **Getting the iOS dependencies in your project**.

Enter both these lines of code from the **Terminal** app on your Mac.

If the install and setup were successful, you should see the message **Setup completed in Terminal**. For more information on CocoaPods, and its usage, see [CocoaPods](https://cocoapods.org/).

The iOS-OneNote-REST Explorer sample has a dependency on the Active Directory Authentication Library for iOS (ADAL) for enabling client to access OneNote for enterprise notebooks. The ADAL provides protocol support for OAuth2, Web API integration with user level consent, and two-factor authentication. It also uses AFNetworking to help manage REST communication between the app and the OneNote service. The sample contains a podfile that will get the ADAL and AFNetworking components (pods) into your project. It's located in the root ("Podfile"). The syntax should look something similar to this:

7. Click the arrow icon on the bottom-right corner of the page.

8. On the **Application information** page, specify a **Redirect URI**, for this example, you can specify http://localhost/OneNoteRESTExplorer, and then select the checkbox in the lower-right hand corner of the page. Remember this value for the below section **Getting the ClientID and RedirectUri into the project**.

9. Once the application has been successfully added, you will be taken to the **Quick Start** page for the application. From here, select **Configure** in the top menu.

11. For the **OneNote** application add the following permissions:

12. For the **Windows Azure Active Directory** application add or make sure the following permissions are enabled:

* Access your organization's directory

13. Copy the value specified for **Client ID** on the **Configure** page. Remember this value for the below section **Getting the ClientID and RedirectUri into the project**.

Finally you'll need to add the Client ID and Redirect Uri you recorded from the previous section **Register your app with Microsoft Azure**.

Browse the **iOS-REST-API-Explorer** project directory and open up the workspace (iOS-REST-API-Explorer). In the **O365Auth.m** file you'll see that the **ClientID** and **RedirectUri** values can be added to the top of the file. Supply the necessary values here:

The REST API Explorer for iOS project uses these classes to manage interactions with OneNote for Enterprise.

This sample demonstrates OneNote REST calls across the notebook, pages, sections, and section groups entities in O365. We use the Master-Detail app template in Xcode as a base. There are three primary sections of interest in the sample hierarchy:

- **Authentication (located in Library/Authentication)** - The OneNote API for iOS uses the Azure Active Directory Library (ADAL) for iOS for connecting your app to Office 365. The ADAL provides protocol support for OAuth2, Web API integration with user level consent, and two-factor authentication. The REST API Explorer uses the ADAL library to authenticate a user who wants to access OneNote for enterprise notebooks. The **Authentication** folder classes Authentication Manager and O365Auth that are responsible for authenticating the app to Office 365. Although not supported in this release, the code for authenticating with Microsoft Accounts (office.com, live.com) will be added in a future release.

General questions about Office 365 development should be posted to [Stack Overflow](http://stackoverflow.com/questions/tagged/Office365+API). Make sure that your questions are tagged with [Office365] and [API].