Basic concepts

ONLYOFFICE Document Serverv7.3

ONLYOFFICE Docs is an open-source office suite that includes editors for text documents, spreadsheets, presentations and fillable forms. It provides the following features:

  • creating, editing and viewing text documents, spreadsheets, presentations and fillable forms;
  • collaborating on files with other teammates in real time.

ONLYOFFICE Docs also supports the WOPI protocol that is used to integrate your application with an online office. Further information about WOPI can be found here.

ONLYOFFICE Docs API is used to let the developers integrate the ONLYOFFICE Document/Spreadsheet/Presentation Editors into their own web sites and setup and manage the editors.

The API JavaScript file can normally be found in the following editors folder:

https://documentserver/web-apps/apps/api/documents/api.js

Where documentserver is the name of the server with the ONLYOFFICE Document Server installed.

The target HTML file where the editors are to be embedded need to have a placeholder div tag, where all the information about the editor parameters will be passed:

  1. <div id="placeholder"></div>
  2. <script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script>

The page code containing the changeable parameters looks the following way:

  1. var docEditor = new DocsAPI.DocEditor("placeholder", config);

Where config is an object:

  1. config = {
  2. "document": {
  3. "fileType": "docx",
  4. "key": "Khirz6zTPdfd7",
  5. "title": "Example Document Title.docx",
  6. "url": "https://example.com/url-to-example-document.docx"
  7. },
  8. "documentType": "word",
  9. "editorConfig": {
  10. "callbackUrl": "https://example.com/url-to-callback.ashx"
  11. }
  12. };

Where example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.

From now the docEditor object can be used to call the document editor Methods.

The example above includes all the parameters necessary for Document Server correct startup. There are additional non-obligatory parameters though which can be changed to achieve different goals with your document (change access rights for the document, display different information about the document, etc.). See the Advanced parameters section to find out what these parameters are and how you can change them.

To prevent the substitution of important parameters, add an encrypted signature to the requests in the form of token.

Get help

If you have any questions about ONLYOFFICE Docs, try to find them in the FAQ section first.

You can request a feature or report a bug by posting an issue on GitHub.

You can also ask our developers on ONLYOFFICE forum (registration required).