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,
   6 version 2.48 (2015-11-01)
   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 1201    Sending messages from inaccessible box is not possible
  28 3006    Marking messages as delivered takes too long. Try again.
  29 3008    Too many parallel requests. Try again later.
  30 3009    Too many requests. Try again later.
  31 5001    FindDataBox: No such box exists (by box ID or registry identifier)
  32
  33 NON-NORMATIVE: ISDS on bogus ISDS request but still valid SOAP request
  34 responses with SOAP non-Fault 200-HTTP Code message. Example:
  35
  36 POST https://www.czebox.cz/DS/dz
  37 <?xml version="1.0" encoding="UTF-8"?>
  38 <Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  39   <Body>
  40     <X-BogusOperation xmlns="http://isds.czechpoint.cz/v20"/>
  41   </Body>
  42 </Envelope>
  43
  44 200
  45 <?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>
  46
  47
  48 Overloading ISDS
  49 ================
  50
  51 The server monitors client's activity (downloading messages, delivery details,
  52 message details, marking messages) and warns user about excessive usage by
  53 sending a system message to his box. The ISDS can limit access to a box per
  54 user as a reaction to abusive server usage. Limiting access means delaying
  55 responses or returning error responses.
  56
  57 Clients must maintain their own history or delivered messages and download
  58 only messages or list of messages that have not yet been delivered.
  59