Query String

An HTTP Query String  can be added at the end of an URL to pass additional information to the server inside the HTTP request. If the request sent demands logic operations on the server side, the information included in the Query String will be available for processing and could be used to personalize the logic operations. In the example below, the Query String specifies the sorting order for the search result asked for by the HTTP Request.

http://www.library.com/search_author/George_R_R_Martin?sort=date

The Query String is located after the question mark (?) and is usually a set of Key-Value Pairs but single value fields are also accepted. Each Key-Value Pair is separated by the ampersand character (&).

µC/HTTP-server

µC/HTTP-server can supports the reception of HTTP requests with Query String. If the feature is enabled, the fields of the Query String will be stored in a list available in the HTTPs_CONN type object passed as argument in all the hook functions.

See Section Query String Configuration to enable the Query String feature.

See Section Query String  for more details on the configuration and usage of this feature.

µC/HTTP-client

µC/HTTP-client supports the addition of a Query String to a request URI. Two methods are offered to add a Query String to an HTTP request. First, a table with all the key-value pairs to include in the Query String can be passed to the µC/HTTP-client stack; second, a hook function can be set up. The hook function will be called by the µC/HTTP-client stack at the moment when the URI is constructed. The hook function asks for one key-value pair at a time and will be called until the function returns a "I'm Done" value.

See Section Query String Configuration to enable the Query String feature.

See Section Query String  for examples on how to set up Query String with a table or with the hook function.