Skip to content

Commit

Permalink
Docs: updates 5xx errors
Browse files Browse the repository at this point in the history
  • Loading branch information
sorenabell committed Dec 12, 2016
2 parents 60bd558 + 37dc3fa commit 8c77e8d
Show file tree
Hide file tree
Showing 3 changed files with 94 additions and 12 deletions.
17 changes: 7 additions & 10 deletions docs/source/errors.rst
Original file line number Diff line number Diff line change
Expand Up @@ -55,38 +55,35 @@ containing additional information.
Rate Limit Enforced. See :ref:`Rate control <performance>`.


Any 5xx error response means abnormal request processing situation and
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).
necessarily guarantee that request has not been performed. For repeatable operations (such as :ref:`2-phase commit <2pc>`, field 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.
or it lacks the ability to fulfill the request. Re-check the 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).
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).
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.
version used in the request. Re-check the request consistency.


Success Response
Expand Down
Binary file modified docs/source/locale/uk/LC_MESSAGES/errors.mo
Binary file not shown.
89 changes: 87 additions & 2 deletions docs/source/locale/uk/LC_MESSAGES/errors.po
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ msgid ""
msgstr ""
"Project-Id-Version: openprocurement.api 0.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-09-21 15:42+0300\n"
"PO-Revision-Date: 2016-09-21 16:20+0200\n"
"POT-Creation-Date: 2016-12-12 13:09+0200\n"
"PO-Revision-Date: 2016-12-12 13:10+0200\n"
"Last-Translator: Zoriana Zaiats <sorenabell@quintagroup.com>\n"
"Language-Team: Ukrainian <info@quintagroup.com>\n"
"MIME-Version: 1.0\n"
Expand Down Expand Up @@ -82,7 +82,11 @@ msgid ""
"No authorization. A valid API key was not provided with the request, so "
"the API could not associate a user with the request."
msgstr ""
<<<<<<< HEAD
"Несанкційонований доступ. Не було надано дійсного API ключа разом із "
=======
" Несанкційонований доступ. Не було надано дійсного API ключа разом із "
>>>>>>> a226658477352411_5xx_err_docs
"запитом, тому API не може зв'язати користувача із запитом."

msgid "403"
Expand Down Expand Up @@ -150,12 +154,93 @@ msgstr ""
"Перевищено допустиму частоту запитів. Дивіться розділ :ref:`Контроль "
"частоти запитів <performance>`."

msgid ""
"Any **5xx error** response means abnormal request processing situation "
"and should be reported to technical support."
msgstr ""
"Будь-яка **5xx помилка** означає проблемну ситуацію з обробкою запиту."
" Повідомте про таку помилку техпідтримку."

msgid ""
"Platform has to properly react to 5xx errors because such errors do not "
"necessarily guarantee that request has not been performed. For repeatable"
" operations (such as :ref:`2-phase commit <2pc>`, field 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)."
msgstr ""
"Майданчик повинен коректно реагувати на 5xx помилки, оскільки такі "
"помилки не завжди гарантують, що запит не відбувся. Для повторюваних "
"операцій (таких як :ref:`двофазний коміт <2pc>`, модифікації значення "
"поля і т.п.) ви повинні повторювати запит з деяким інтервалом. Для решти "
"операцій (таких як завантаження документа і т.п.) ви повинні періодично "
"(5-10 хв) перевіряти дані модифікованого об'єкта (закупівлі, пропозиції, "
"конктракту і т.п.)."

msgid "500"
msgstr "500"

msgid "Server error. There was a problem on OpenProcurement's end."
msgstr "Помилка сервера. Була проблема зі сторони OpenProcurement."

msgid "501"
msgstr "501"

msgid ""
"Not Implemented. The server either does not recognize the request method,"
" or it lacks the ability to fulfill the request. Re-check the request "
"consistency."
msgstr ""
"Метод не підтримується. Сервер або не розпізнає метод запиту, або в нього"
" немає можливості його виконати. Повторно перевірте відповідність запиту."

msgid "502"
msgstr "502"

msgid ""
"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."
msgstr ""
"Помилка шлюзу. Сервер отримав відповідь про помилку чи не готовий "
"обробляти запити. Для повторюваних операцій повторіть запит або "
"перевіряйте дані об'єкту з інтервалом 1-5 хв."

msgid "503"
msgstr "503"

msgid ""
"Service Unavailable. The server is currently unavailable (because it is "
"overloaded or down for maintenance). Generally, this is a temporary "
"state."
msgstr ""
"Сервіс недоступний. На даний момент сервер недоступний (через "
"перевантаження чи технічне обслуговування). Переважно ця помилка "
"тимчасова."

msgid "504"
msgstr "504"

msgid ""
"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."
msgstr ""
"Шлюз не відповідає. Сервер не дочекався відповіді. Для повторюваних "
"операцій повторіть запит або перевіряйте дані об'єкту з інтервалом 1-5 "
"хв."

msgid "505"
msgstr "505"

msgid ""
"HTTP Version Not Supported. The server does not support the HTTP protocol"
" version used in the request. Re-check the request consistency."
msgstr ""
"Версія НТТР не підтримується. Сервер не підтримує версію протоколу HTTP, "
"використану у запиті. Повторно перевірте відповідність запиту."

msgid "Success Response"
msgstr "Відповідь з повідомленням про успіх"

Expand Down

0 comments on commit 8c77e8d

Please sign in to comment.