Controlling Webdata's HTTP Responses

Top  Previous  Next

The HTTP response provided by the Webdata API can be controlled and customized by creating a file named 'response.txt' in the same directory on the web server where 'webdata.exe' resides.

 

If 'response.txt' does not exist, Webdata will provide a default response of:
content-type: text/html

status: 200

<html>

<body>

%Filename%

</body>

</html>

 

However, if your sending system requires a specific response or additional information, you can provide its template in the 'response.txt' file.

 

For example, you can use the Webdata API to host a very basic WCTP receiver by using this as the response template:

 

<?xml version="1.0"?>

<!DOCTYPE wctp-Operation

SYSTEM "http://dtd.wctp.org/wctp-dtd-v1r1.dtd">

<wctp-Operation wctpVersion="wctp-dtd-v1r1" wctpToken="11AA">

   <wctp-SubmitClientResponse>

       <wctp-ClientSuccess

           successCode="200"

           successText="Message accepted for processing"

           trackingNumber="%FileIndex%"

       >

           Message accepted for processing

       </wctp-ClientSuccess>

   </wctp-SubmitClientResponse>

</wctp-Operation>

 

There are two variables that can be used in the Webdata API's response template.

 

Value

Function

%Filename%

Outputs the name of the file created by submitting data to webdata.exe

%FileIndex%

Outputs the number of the relative-index kept by Webdata.

 

This number resets as data is processed and provides a somewhat unique value for responses.