Interactive REST API: How to Defer Answering A Question
This example demonstrates how your web-service should respond to a question it has no answer for or to a
non-business related question.
Note: A business account is required to utilize this API.
Data Formats Sent and Received
HTTPS POST - REST
REST API Parameters
This is the name of an item the user is interested in.
The attribute of the object whose name is the object parameter.
Verb applies more to a condition of the value in the target field.
This is usually today's date in XML Format YYYY-MM-DD.
opening hours for this date
This allows the user to further refine the value in target.
This is the 2 letter state or province code at the user's current location.
This is the postal code at the user's current location.
The latitude in radians of the user's location.
The longitude in radians of the user's location.
The ISO3 country code.
The UTC offset in minutes from the user's local time.
This is the arghon developer key.
API Response XML Fields
A name that describes the answer. In most cases its the value in the target parameter from the request.
Tells the successfulness or failure of the request.
Set to -1 to defer answering the question to Arghon.
Note: All other return fields will be ignored, so they may be left empty.
Each answer is rated for an age appropriate audience.
See AnswerFormatType in the xsd specification file.
An answer can be a list or a single value.
Set to 1 if the result can be cached.
This is a number that communicates quantity, price or value.
This is the answer to the user's request (question).
The URL Arghon connects to is specified by you on the developer profile page in the communication URL field.
REST Request of user asking a business for the size of the universe:
https://yourwebsite.com/services/arghoninteractive/ HTTP POST
XML response, deferring answering size of universe question: