doc/web_service_interface

   1 Web service interface
   2 =====================
   3
   4 Source: Provozní řád informačního systému (2015-06-07)
   5 Source: Webové služby ISDS pro manipulaci s datovými zprávami, version 2.6
   6 (2010-01-18) [DataMessage_ws.pdf], Page 5
   7 Source: Webové služby ISDS pro vyhledávání datových schránek,
   8 version 2 (2009-07-26)
   9
  10
  11 Web services for messages are synchronous, web services for boxes are
  12 asynchronous.
  13
  14
  15 Error Reporting
  16 ===============
  17
  18 Result code of web service operation is stored in dmStatus/@dmStatusCode.
  19 Known values:
  20
  21 Code    Meaning
  22 -----------------------------------------------------------------------------
  23 0000    Means success
  24 0002    FindDataBox: No box suits to search request (by name)
  25 0003    FindDataBox: To much boxes suit to search request (by name), response
  26             truncated
  27 3006    Marking messages as delivered takes too long. Try again.
  28 5001    FindDataBox: No such box exists (by box ID or registry identifier)
  29
  30 NON-NORMATIVE: ISDS on bogus ISDS request but still valid SOAP request
  31 responses with SOAP non-Fault 200-HTTP Code message. Example:
  32
  33 POST https://www.czebox.cz/DS/dz
  34 <?xml version="1.0" encoding="UTF-8"?>
  35 <Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  36   <Body>
  37     <X-BogusOperation xmlns="http://isds.czechpoint.cz/v20"/>
  38   </Body>
  39 </Envelope>
  40
  41 200
  42 <?xml version='1.0' encoding='utf-8'?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><SOAP-ENV:Body><q:X-BogusOperationResponse xmlns:q="http://isds.czechpoint.cz/v20" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><q:dmStatus><q:dmStatusCode>2006</q:dmStatusCode><q:dmStatusMessage>Unknown operation: X-BogusOperation</q:dmStatusMessage></q:dmStatus></q:X-BogusOperationResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>
  43
  44
  45 Overloading ISDS
  46 ================
  47
  48 The server monitors client's activity (downloading messages, delivery details,
  49 message details, marking messages) and warns user about excessive usage by
  50 sending a system message to his box. The ISDS can limit access to a box per
  51 user as a reaction to abusive server usage. Limiting access means delaying
  52 responses or returning error responses.
  53
  54 Clients must maintain their own history or delivered messages and download
  55 only messages or list of messages that have not yet been delivered.
  56