Common Response Info

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": {
    ...
    ...
    ...
}
}
$

 Semantic Signature is a registered trademark - © 2010 TextWise, LLC. All rights reserved. Privacy Policy