Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This XML DTD Validator policy executes after the request has been authenticated. You can use both the XML DTD and XML XSD policies concurrently as long as the schemas do not conflict.

...

  • HTTP Clients are expected to provide a <!DOCTYPE> tag to indicate validation against Document Type Definitions. Without the tag, validation fails.

  • The parameter just after !DOCTYPE is expected to be the same as the outermost tag in the XML. If not, validation fails.

  • Externally referenced DTDs are declared with the following system callout: SYSTEM "policy.dtd".

    • <!DOCTYPE outermost_object SYSTEM "external_reference.dtd"> is the standard callout format for specifying DTD validation against external references.

    • For validation against the policy’s Document Type Definitions, HTTP clients are required to specify the SYSTEM declaration.

      • As the API admin, you can instruct clients to use any SYSTEM parameter following the callout. Any value can be specified. See the "policy.dtd" callout.

      • Regardless of the value, the XML DTD Validator uses the definitions specified in the policy to validate external references.

Code Block
<!DOCTYPE books SYSTEM "policy.dtd">
<books>
    <book id="bk001">
      ... 
    </book>
</books>

...

API Managers may instruct their clients to use any SYSTEM parameter following the callout, but any value can be specified. See the "policy.dtd" callout.

...