HotBits XML Document Type Definition

This is the XML Document Type Definition for data returned by HotBits in XML format.


<!--                   HotBits
            http://www.fourmilab.ch/hotbits/

              XML Document Type Definition

    This definition is cited with a:
        <!DOCTYPE hotbits SYSTEM
            "http://www.fourmilab.ch/hotbits/hotbits.dtd">
    declaration in compliant XML files.

-->

    <!-- Root element -->

    <!ELEMENT hotbits
        (status, request-information?, random-data?)
    >

    <!ATTLIST hotbits
        version     CDATA   #REQUIRED
    >

    <!-- Every HotBits result contains a status
         element.  The status element contains a
         result attribute which is 200-299 for a normal
         result and greater in case of error.
         The status element contains text which is
         "OK" for a normal result or an error
         message explaining the error status. -->

    <!ELEMENT status                (#PCDATA)>

    <!ATTLIST status
        version     CDATA   #REQUIRED
        result      CDATA   #REQUIRED
    >

    <!--  The request-information element is present only
          for a normal (status result="2xx") result. It is a
          container for the generation-time,
          bytes-requested, and bytes-returned elements. -->

    <!ELEMENT request-information
        (server-version,
         generation-time,
         bytes-requested,
         bytes-returned,
         quota-requests-remaining,
         quota-bytes-remaining
        )
    >

    <!ATTLIST request-information
        version     CDATA   #REQUIRED
    >

    <!-- The server-version element is a string (format not
         specified) which uniquely identifies the software version
         of the server responding to the request. -->
    <!ELEMENT server-version        (#PCDATA)>

    <!-- The generation-time element contains the universal
         time of the request in a format like:
                2008-06-17T12:13:00Z -->
    <!ELEMENT generation-time       (#PCDATA)>

    <!-- The bytes-requested element specifies the number of
         bytes requested by the user as a decimal number. -->
    <!ELEMENT bytes-requested       (#PCDATA)>

    <!-- The bytes-returned element specifies the number of
         bytes returned as a decimal number.  If the user's
         request was limited due to maximum request size or
         quota enforcement, this will be less than
         bytes-requested. -->
    <!ELEMENT bytes-returned        (#PCDATA)>

    <!-- The quota-requests-remaining element gives the
         number of requests remaining before subsequent
         requests are denied due to exceeding the quota. -->
    <!ELEMENT quota-requests-remaining (#PCDATA)>

    <!-- The quota-bytes-remaining element gives the
         number of bytes remaining before subsequent
         requests are denied due to exceeding the quota. -->
    <!ELEMENT quota-bytes-remaining (#PCDATA)>

    <!-- The random-data element, which appears only in normal
         status requests, contains the random bytes (whose
         number is given by the bytes-returned element above)
         as a sequence of two-digit hexadecimal values separated
         by white space.  For readbility, the sequence is broken
         into lines containing 16 hexadecimal values each. -->
    <!ELEMENT random-data           (#PCDATA)>

    <!ATTLIST random-data
        version     CDATA   #REQUIRED
    >

Sample HotBits XML Result

Request HotBits

HotBits Main Page