Added section describing the file uploading rules. Ref: #5. a18673866971731

Author: myroslav

docs/source/index.rst

@@ -20,6 +20,7 @@ Contents:
    errors
    options
    dates
+   upload
    tutorial
    tenders
    procuring

docs/source/procuring.rst

@@ -29,7 +29,7 @@ Uploading documentation
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 All tender documentation should be uploaded following requests one request
-per document. You can see supported request types in Documents Uploading section.
+per document. You can see supported request types in :ref:`upload` section.
 
 .. sourcecode:: http
 
@@ -69,7 +69,7 @@ Changing existing documents
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Procuring Entity can upload new versions of the tender documentation. You
-can see supported request types in Documents Uploading section.
+can see supported request types in :ref:`upload` section.
 
 .. sourcecode:: http
 

docs/source/upload.rst

@@ -0,0 +1,24 @@
+.. _upload:
+
+Documents Uploading
+===================
+
+All of the document uploading API endpoints follows the same set of rules.
+
+Content-Type: multipart/formdata
+--------------------------------
+
+This is normal approach of file uploading defined by `RFC 1867
+<http://www.faqs.org/rfcs/rfc1867.html>`_.  The requirements are:
+
+* Form element should have name `file`
+* Only one document can be uploaded.
+
+The cURL example::
+
+    curl --form file=@page.pdf http://api-sandbox.openprocurement.org/api/0/tenders/f6882fa63d5141bcabec54a4766eec61/documents
+
+HTTPie example::
+
+    http -f POST http://api-sandbox.openprocurement.org/api/0/tenders/f6882fa63d5141bcabec54a4766eec61/documents file@page.pdf
+