Using the WOPI protocol to integrate with Office Online¶
You can use the Web Application Open Platform Interface (WOPI) protocol to integrate Office Online with your application. The WOPI protocol enables Office Online to access and change files that are stored in your service.
To integrate your application with Office Online, you need to do the following:
- Be a member of the Office 365 - Cloud Storage Partner Program. Currently integration with the Office Online cloud service is available to cloud storage partners. You can learn more about the program, as well as how to apply, at http://dev.office.com/programs/officecloudstorage.
- Implement the WOPI protocol - a set of REST endpoints that expose information about the documents that you want to view or edit in Office Online. The set of WOPI operations that must be supported is described in the section titled WOPI implementation requirements for Office Online integration.
- Read some XML from an Office Online URL that provides information about the capabilities that Office Online applications expose, and how to invoke them; this process is called WOPI discovery.
- Provide an HTML page (or pages) that will host the Office Online iframe. This is called the host page and is the page your users visit when they open or edit Office documents in Office Online.
- You can also optionally integrate your own UI elements with Office Online. For example, when users choose Share in Office Online, you can show your own sharing UI. These interaction points are described in the section titled Using PostMessage to interact with the Office Online application iframe.
How to read this documentation¶
This documentation contains an immense amount of information about how to integrate with Office Online, including details about how to implement the WOPI protocol, how Office Online uses the protocol, how you can test your integration, the process for shipping your integration, and much more. It can be difficult to know where to begin. The following guidelines can help you find the specific sections in this documentation that will be most helpful to you.
If you want to know why Office Online integration may be useful to you, and what capabilities it provides, you should read the following sections:
- Integrating with Office Online - A high level overview of the scenarios enabled by Office Online integration, as well as a brief description of some of the key technical elements in a successful integration.
- Using the WOPI protocol to integrate with Office Online - A brief description of the technical pieces that you must implement to integrate with Office Online.
If you are an engineer about to begin implementing a WOPI host, you should first read the Key concepts section. When designing your WOPI implementation, you must keep in mind the expectations around file IDs, access tokens, and locks. These concepts are critical to a successful integration with Office Online. You should also read the following sections:
- WOPI Validation application
- Troubleshooting interactions with Office Online
- Office Online environments
If you are a back-end engineer, you should begin with the following sections in addition to the Key concepts section and other general sections listed above:
If you are a front-end engineer, you should begin with the following sections in addition to the Key concepts section and other general sections listed above:
- Building a host page
- Using PostMessage to interact with the Office Online application iframe
- WOPI discovery, specifically the WOPI actions section
Finally, if you are looking for more details about the process for shipping your integration, see the Shipping your Office Online integration section.