NumGetNumberStatus

Возвращает статус номера в нумераторе.

Запрос

POST /DocsVision/StorageServer/StorageServerService.asmx HTTP/1.1
Host: DOCSVISION_SERVER.COM
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/NumGetNumberStatus"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <NumGetNumberStatus xmlns="http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/">
      <sessionId>guid</sessionId>
      <numeratorId>guid</numeratorId>
      <zoneName>string</zoneName>
      <number>int</number>
    </NumGetNumberStatus>
  </soap:Body>
</soap:Envelope>
Параметры
sessionId

Идентификатор пользовательской сессии

numeratorId

Идентификатор номера

zoneName

Название зоны нумератора

number

Проверяемый номер

Ответ

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <NumGetNumberStatusResponse xmlns="http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/">
      <numberStatus>NUMBER_STATUS_FREE or NUMBER_STATUS_IN_USE or NUMBER_STATUS_RESERVED or NUMBER_STATUS_NOT_EXISTS</numberStatus>
    </NumGetNumberStatusResponse>
  </soap:Body>
</soap:Envelope>
Ответ может содержать значение:

  • NUMBER_STATUS_FREE — не занят.

  • NUMBER_STATUS_IN_USE — занят.

  • NUMBER_STATUS_RESERVED — зарезервирован.

  • NUMBER_STATUS_NOT_EXISTS — не существует, выходит за диапазон номеров зоны, указанной в zoneName.

Пример запроса

session.headers['SOAPAction'] = "http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/NumGetNumberStatus" (1)

body = """<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <NumGetNumberStatus xmlns="http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/">
      <sessionId>6565c75b-298d-e511-9417-90e6ba57b9f8</sessionId>
      <numeratorId>A16E9792-5B88-E511-9417-90E6BA57B9F8</numeratorId>
      <zoneName>SimpleZone</zoneName>
      <number>5</number>
    </NumGetNumberStatus>
  </soap:Body>
</soap:Envelope>""" (2)

response = session.post(url, data=body) (3)

responseParsed = ElementTree.fromstring(response.content)
print(responseParsed.findtext(".//{http://schemas.docsvision.com/Platform/2009-02-03/StorageServer/}numberStatus")) (4)
1 Изменяем цель запроса в заголовке запроса.
2 SOAP-сообщение.
3 Отправляем SOAP-сообщение.
4 Разбираем ответ и выводим статус номера.