CheckFileInfo

GET /wopi/files/(file_id)

Returns information about the file properties, access rights and editor settings.

Parameters
Name Description Type
file_id The file ID that must be URL safe. string
Query parameters
Name Description Type
access_token An access token that the host will use to determine whether the request is authorized. string
Request headers
Name Description Type Presence
X-WOPI-SessionContext Session context if it is provided on the initial WOPI action URL. string optional
Required response properties
Name Description Type Example
A file name without a path that is displayed in the user interface (UI) and determines the file extension. string "Example File Name.docx"
A unique user identifier that is specified by the WOPI server. string "uid-1"
Breadcrumb properties
Name Description Type Example
A name that the WOPI client displays to the user to indicate the brand name of the WOPI server. string "Example Brand Name"
URL to a web page that the WOPI client navigates to when the user clicks the UI displaying BreadcrumbBrandName. string "https://example.com/url-to-breadcrumb-brand-page.com"
A file name that the WOPI client displays to the user. If this parameter is not specified, then the BaseFileName parameter is used. string "Example Breadcrumb File Name.docx"
A name that the WOPI client displays to the user that indicates the name of the folder that contains the file. string "Example Folder Name"
URL to a web page that the WOPI client navigates to when the user clicks the UI displaying BreadcrumbFolderName. string "https://example.com/url-to-breadcrumb-brand-folder"
PostMessage properties
Name Description Type Example
Specifies if the WOPI client should notify the WOPI server in case the user closes the rendering or editing client currently using this file. The host expects to receive the UI_Close PostMessage when the Close UI in the online office is activated. boolean true
Specifies if the WOPI client should notify the WOPI server in case the user tries to edit a file. The host expects to receive the UI_Edit PostMessage when the Edit UI in the online office is activated. boolean true
Specifies if the WOPI client should notify the WOPI server in case the user tries to edit a file. The host expects to receive the Edit_Notification PostMessage. boolean true
Specifies if the WOPI client should notify the WOPI server in case the user tries to share a file. The host expects to receive the UI_Sharing PostMessage when the Share UI in the online office is activated. boolean true
Specifies if the WOPI client will notify the WOPI server in case the user tries to navigate to the previous file version. The host expects to receive the UI_FileVersions PostMessage when the Previous Versions UI in the online office is activated. boolean true
A domain that the WOPI client must use as the targetOrigin parameter when sending messages as described in [W3C-HTML5WEBMSG]. string "https://exampledomain.com"
File URL properties
Name Description Type Example
URL to a web page that the implementer deems useful to the user in case the user closes the rendering or editing client currently using this file. string "https://example.com/url-to-close-page.com"
URL to the location that allows the user to share a file. string "https://example.com/url-to-sharing-page.com"
URL to the location that allows the user to view the previous file version. string "https://example.com/url-to-previous-version-page.com"
URL to a web page where a file can be edited using the WOPI client. string "https://example.com/url-to-host-page.com"
Other miscellaneous properties
Name Description Type Example
Specifies if the WOPI client must disable any print functionality under its control. boolean true
A file extension which must begin with a ".". string ".docx"
The maximum length of a file name, including the file extension, supported by the WOPI server. integer 20
User metadata properties
Name Description Type Example
Specifies if the user is anonymous. boolean true
A user name. If it is undefined, the WOPI client may be configured to use a placeholder string in some scenarios, or to show no name at all. string "John Smith"
User permissions properties
Name Description Type Example
Specifies if a file cannot be changed by the current user. boolean true
Specifies if the user has permissions to rename a file. boolean true
Specifies if the user has permissions to review a file. boolean true
Specifies if the user has permissions to edit a file. boolean true
WOPI host capabilities properties
Name Description Type Example
Specifies if the WOPI server supports the renaming permission. boolean true
Specifies if the WOPI server supports the review permission. boolean true
Nextcloud/Collabora/Seafile properties
Name Description Type Example
Specifies if the WOPI server hides the print option from the file menu bar in the UI. boolean false