Skip to content

Commit d9bada7

Browse files
salmart-devsalmart-dev
committed
chore: add new X-NC-WebDAV-Auto-Mkcol header
Signed-off-by: Salvatore Martire <4652631+salmart-dev@users.noreply.github.com>
1 parent 91097d8 commit d9bada7

1 file changed

Lines changed: 32 additions & 29 deletions

File tree

‎developer_manual/client_apis/WebDAV/basic.rst‎

Lines changed: 32 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -512,35 +512,38 @@ Request Headers
512512
513513
You can set some special headers that Nextcloud will interpret.
514514
515-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
516-
| Header | Description | Example |
517-
+=================+=================================================================+==========================================+
518-
| X-OC-MTime | | Allow to specify a modification time. | ``1675789581`` |
519-
| | | The response will contain the header ``X-OC-MTime: accepted`` | |
520-
| | | if the mtime was accepted. | |
521-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
522-
| X-OC-CTime | | Allow to specify a creation time. | ``1675789581`` |
523-
| | | The response will contain the header ``X-OC-CTime: accepted`` | |
524-
| | | if the mtime was accepted. | |
525-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
526-
| OC-Checksum | | A checksum that will be stored in the DB. | ``md5:04c36b75222cd9fd47f2607333029106`` |
527-
| | | The server will not do any sort of validation. | |
528-
| | | Currently used algorithms are ``MD5``, ``SHA1``, ``SHA256``, | |
529-
| | | ``SHA3-256``, ``Adler32``. | |
530-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
531-
| X-Hash | | Allow to request the file's hash from the server. | ``md5``, ``sha1``, or ``sha256`` |
532-
| | | The server will return the hash in a header named either: | |
533-
| | | ``X-Hash-MD5``, ``X-Hash-SHA1``, or ``X-Hash-SHA256``. | |
534-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
535-
| OC-Total-Length | | Contains the total size of the file during a chunk upload. | ``4052412`` |
536-
| | | This allow the server to abort faster if the remaining | |
537-
| | | user's quota is not enough. | |
538-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
539-
| OC-Chunked | | Used for legacy chunk upload to differentiate a regular | Deprecated ⚠️ |
540-
| | | upload from a chunked upload. It allowed checking for quota | |
541-
| (deprecated) | | and various other things. Nowadays, you need to provide the | You do not have to provide this anymore |
542-
| | | ``OC-Total-Length`` header on the ``PUT`` requests instead. | |
543-
+-----------------+-----------------------------------------------------------------+------------------------------------------+
515+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
516+
| Header | Description | Example |
517+
+=======================+=================================================================+==========================================+
518+
| X-OC-MTime | | Allow to specify a modification time. | ``1675789581`` |
519+
| | | The response will contain the header ``X-OC-MTime: accepted`` | |
520+
| | | if the mtime was accepted. | |
521+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
522+
| X-OC-CTime | | Allow to specify a creation time. | ``1675789581`` |
523+
| | | The response will contain the header ``X-OC-CTime: accepted`` | |
524+
| | | if the mtime was accepted. | |
525+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
526+
| OC-Checksum | | A checksum that will be stored in the DB. | ``md5:04c36b75222cd9fd47f2607333029106`` |
527+
| | | The server will not do any sort of validation. | |
528+
| | | Currently used algorithms are ``MD5``, ``SHA1``, ``SHA256``, | |
529+
| | | ``SHA3-256``, ``Adler32``. | |
530+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
531+
| X-Hash | | Allow to request the file's hash from the server. | ``md5``, ``sha1``, or ``sha256`` |
532+
| | | The server will return the hash in a header named either: | |
533+
| | | ``X-Hash-MD5``, ``X-Hash-SHA1``, or ``X-Hash-SHA256``. | |
534+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
535+
| OC-Total-Length | | Contains the total size of the file during a chunk upload. | ``4052412`` |
536+
| | | This allow the server to abort faster if the remaining | |
537+
| | | user's quota is not enough. | |
538+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
539+
| X-NC-WebDAV-AutoMkcol | | When set to ``1``, instructs the server to automatically | |
540+
| | | create any missing parent directories when uploading a file. | |
541+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
542+
| OC-Chunked | | Used for legacy chunk upload to differentiate a regular | Deprecated ⚠️ |
543+
| | | upload from a chunked upload. It allowed checking for quota | |
544+
| (deprecated) | | and various other things. Nowadays, you need to provide the | You do not have to provide this anymore |
545+
| | | ``OC-Total-Length`` header on the ``PUT`` requests instead. | |
546+
+-----------------------+-----------------------------------------------------------------+------------------------------------------+
544547
545548
Response Headers
546549
----------------

0 commit comments

Comments
 (0)