Merge remote-tracking branch 'origin/a226658477352411_5xx_err_docs'

docs/source/errors.rst

@@ -54,9 +54,41 @@ containing additional information.
 429
   Rate Limit Enforced. See :ref:`Rate control <performance>`.
 
+
+Any 5xx error response means abnormal request processing situation and
+should be reported to technical support.
+Platform has to properly react to 5xx errors because such errors do not
+necessarily guarantee that request was not performed. For repeatable operations
+(such as 2-phase commit, fieds value modifications, etc.) you should repeat
+the request with some interval. For other operations (such as document
+upload, etc.) you should check modified object data (tender, bid, award, etc.)
+with bigger interval (5-10 min).
+
 500
   Server error. There was a problem on OpenProcurement's end.
 
+501
+  Not Implemented. The server either does not recognize the request method,
+  or it lacks the ability to fulfill the request. Re-check request consistency.
+
+502
+  Bad Gateway. The server received an invalid response or backend is not ready
+  to handle requests. Repeat request for repeatable operations or check object
+  data with interval (1-5 min).
+
+503
+  Service Unavailable. The server is currently unavailable (because it is
+  overloaded or down for maintenance). Generally, this is a temporary state.
+
+504
+  Gateway Time-out. The server did not receive a timely response. Repeat
+  request for repeatable operations or check object data with interval (1-5 min).
+
+505
+  HTTP Version Not Supported. The server does not support the HTTP protocol
+  version used in the request. Re-check request consistency.
+
+
 Success Response
 ----------------
 Every successful get, create, update, replace request results in response

setup.py

@@ -44,7 +44,7 @@
 }
 
 setup(name='openprocurement.api',
-      version='2.3.37',
+      version='2.3.38',
       description='openprocurement.api',
       long_description=README,
       classifiers=[