About Fields

Overview

All successful responses sent from the API include a header containing information about the request that caused the response to be produced. This 'about' section will be the first area included within the response and will contain information describing what was processed and when, and any metadata or external id the call requested to be returned. Following is a summary of the fields contained within the 'about' section:

Field Description
externalId A caller-defined value that is echoed back in the response.
requestId TextWise-generated request ID unique for each request.
docId For the RDF format this is a unique identifier for each request; for all other formats it is an internally generated document ID that is a hash of either the input URI or the input text.
systemType Identifier of the service call that was executed ("signature", "match", "category", etc).
configId The identifier of the system configuration used when executing the request. The value will be the same as the configuration identifier specified at the end of the signature, category, and concept call request path or the default configuration ID if one was not specified.
externalMetadata A caller-defined value echoed back in the response.
requestDate An ISO_8601 formatted date that represents when the request was submitted.
systemVersion Identifies the version of the system that serviced the request.
contentDigest A digest of the provided text or content that was fetched from a provided URI.
contentType The MIME type of the provided or fetched content.
sourceUri The URI specified in the request.

XML Response Example

<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://www.semantichacker.com/api">
        <about>
                <requestId>71E12DCF2B14CB9BD89B4444F3353633</requestId>
                <docId>BA0D26C21A91581510DE71253E523B8C</docId>
                <systemType>signature</systemType>
                <configId>odp_2007_l1_1.7k</configId>
                <contentType>text/html</contentType>
                <contentDigest>9D546459ABDE535997FFCC92B293C49D</contentDigest>
                <requestDate>2011-08-31T15:01:03+00:00</requestDate>
                <systemVersion>2.1</systemVersion>
                <sourceUri>http://www.distrowatch.org</sourceUri>
        </about>
        <siggen>
        ...
        ...
        ...
        </siggen>
</response>

JSON Response Example

{
    "about":     {
        "requestId": "0B9A7E0B14C965B2DCBF631D822B5F84",
        "docId": "BA0D26C21A91581510DE71253E523B8C",
        "systemType": "signature",
        "configId": "odp_2007_l1_1.7k",
        "contentType": "text/html",
        "contentDigest": "9D546459ABDE535997FFCC92B293C49D",
        "requestDate": "2011-08-31T15:02:58+00:00",
        "systemVersion": "2.1",
        "sourceUri": "http://www.distrowatch.org"
    },
    "siggen": {
    ...
    ...
    ...
}
}