Update aria2c.rst

pull/629/head
ITriskTI 2016-04-18 15:54:39 +03:00
parent c9e2223741
commit 3a6f39ca7a
1 changed files with 70 additions and 31 deletions

View File

@ -2371,9 +2371,9 @@ RPC-метод `system.multicall` обрабатывается особым об
против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным
или `system.multicall` запросам, когда это необходимо. или `system.multicall` запросам, когда это необходимо.
`system.listMethods` может выполняться без секретного маркера. Так он `system.listMethods` и `system.listNotifications` могут выполняться без секретного маркера. Так они
просто возвращает все доступные методы, и ничего не изменяет, это просто возвращает доступные методы/уведомления, и ничего не изменяют, они
безопасно без секретного маркера. безопасны без секретного маркера.
Методы Методы
~~~~~~ ~~~~~~
@ -2723,6 +2723,15 @@ RPC-метод `system.multicall` обрабатывается особым об
``name`` ``name``
имя в разделе info. Используется ``name.utf-8``, если доступно. имя в разделе info. Используется ``name.utf-8``, если доступно.
``verifiedLength``
Количество проверенных байт во время проверки хэша. Это поле
появляется только тогда, когда загрузка начинает проверять хэш.
``verifyIntegrityPending``
``true`` - если эта загрузка ожидает в очереди проверки хэша.
Это поле появляется только тогда, когда эта загрузка находится
в очереди.
**Пример JSON-RPC** **Пример JSON-RPC**
Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829:: Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829::
@ -3607,6 +3616,36 @@ RPC-метод `system.multicall` обрабатывается особым об
>>> s.system.listMethods() >>> s.system.listMethods()
['aria2.addUri', 'aria2.addTorrent', ... ['aria2.addUri', 'aria2.addTorrent', ...
.. function:: system.listNotifications()
Этот метод возвращает все доступные RPC-методы в массиве строк.
В отличие от других методов, этот метод не требует секретный маркер.
Это безопасно, потому что этот метод просто возвращает названия доступных
уведомлений.
**Пример JSON-RPC**
::
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'system.listNotifications'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [u'aria2.onDownloadStart',
u'aria2.onDownloadPause',
...
**Пример XML-RPC**
::
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.system.listNotifications()
['aria2.onDownloadStart', 'aria2.onDownloadPause', ...
Обработка ошибок Обработка ошибок
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~