PutRelativeFile
POST /wopi/files/(file_id)
Creates a new file on the host based on the current file.
This operation works as follows:
- The WOPI host checks if a file is currently locked or not.
- If the file is currently locked and the X-WOPI-Lock value does not match the lock currently on the file, the host must return 409 Conflict (“lock mismatch”) and include the X-WOPI-Lock response header containing the value of the current lock on the file. In the case where the file is unlocked, the host must set X-WOPI-Lock to the empty string.
- If the file is unlocked, the host takes the file name from the X-WOPI-SuggestedTarget header and modifies it in order to make the request succeed:
- If the header contains only a file extension (starts with a period), then the resulting file name will consist of this extension and the initial file name without extension.
- If the header contains a full file name, then it will be a name for the resulting file.
- Finally, the host creates a new file that has a legal name and does not overwrite any existing files, while preserving the file extension.
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-Override | The requested operation from the WOPI server (PUT_RELATIVE). | string | required |
X-WOPI-SuggestedTarget | A file extension or a full file name, including the file extension in the format of the UTF-7 encoded string. | string | required |
X-WOPI-Size | The size of the file in bytes. | integer | optional |
X-WOPI-FileConversion | Indicates that the request is being made in the context of binary document conversion. | boolean | optional |
Request body
The request body must contain the full file contents in the binary format.
Response headers
Name | Description | Type | Presence |
X-WOPI-Lock | The lock ID identifying the current lock on the file. This header must always be included when responding to the request with 409 Conflict. It should not be included when responding to the request with 200 OK. | string | optional |
X-WOPI-LockFailureReason | The cause of the lock failure. This header may be included when responding to the request with 409 Conflict. It must only be used for logging purposes. | string | optional |
Response body
Name | Description | Type | Presence |
Name | The file name, including extension, without a path. | string | required |
Url | URI of the form http://server/<...>/wopi/files/(file_id)?access_token=(access token), of the newly created file on the host. | string | required |
HostViewUrl | URI to a host page that loads the view WOPI action for the newly created file. | string | optional |
HostEditUrl | URI to a host page that loads edit action for the newly created file. | string | optional |
当前内容版权归 Onlyoffice 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 Onlyoffice .