You are here
Common Request Info
Unless otherwise specified within the documentation of a specific service, all services accept a set of common request parameters to control behavior such as obtaining content or specifying how the response is produced. The following table define what these parameters are as well as what they control.
All TextWise API services require the request to 'indicate' content. This can be done in several ways. First, the request can include a URI as a parameter to direct the service to a particular document. Of course this URI must be publicly accessible so that our servers can view it. Another option for short content is to assign a parameter named 'content' to the content value you wish the service to process. And lastly you can send the content in the body of an HTTP request. You may use POST, PUT, and multi-part file upload request styles. For a more detailed specification of HTTP requests, see our API Request Reference.
Content and URI Rules:
If both a URI and a content parameter or content upload are used in a single request the API will return an error. If both a content parameter and a content upload are sent, the value of the content parameter will be appended to the request body, prefixed by a new line.
Many of services also allow for an optional configuration ID to be provided at the end of the request path. For example, the URL path http://api.semantichacker.com/TOKEN/category/gist_cat_odp2010 would return a category created from our 1005 'Open Directory Project' based categories. Visit the Service Configurations page to view all currently available service configuration IDs.
The filter parameter indicates how the indicated content will be scrubbed before being used. See the documentation on the Filter Service for detailed information on how to use this parameter effectively.