×
Namespaces

Variants
Actions
(Redirected from HTTP service)

Archived:HTTP service in WidSets

From Nokia Developer Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The article is believed to be still valid for the original topic scope.

Article Metadata
Article
Created: User:Mirsilla (28 May 2008)
Last edited: hamishwillee (29 Jun 2012)
FNWID.gif

Contents

The service

With the HTTP service the script can execute HTTP GET and HTTP POST methods. If the MIME type of the response is human readable text ("text/..."), the response is a string, otherwise it is binary. The output of the HTTP service can be processed with a filter. (See Archived:Advanced filters.)

The HTTP service can have the following service parameters that are configured in the XML configuration:

Service parameter Function
auth When using TOKEN authentication, the service id of the tokenauth type service must be set here. (See Archived:Token authentication in WidSets for an example.)

HTTP service has two actions that are called from the script code:

Service action Function
get get executes a HTTP GET to the URL specified.
post post executes a HTTP POST to the URL specified.

With get and post actions, additional request parameters can be added. In get, only the string type parameters will be appended to the querystring, and in post depending on the nature of the parameters they will be either sent as:

Content-Type: application/x-www-form-urlencoded; charset=utf-8

when all parameter values are strings

OR

Content-Type: multipart/form-data

when there are also other types of parameter values than strings. The values of other types must be accompanied with the MIME type of the data.


Service actions

The following are the specifications for the available service actions.


Get

/* Action get */

input = (use FetchInput)

output = (use Content)

Post

/* Action post */

input = (use FetchInput)

output = (use Content)


  Content = (choice (string textContent)
                    (bytes dataContent)
                    (any filteredData)
                    (null noData))

  Headers = (list (repeat (bind (string name) (string value))))

  FetchInput = (list (bag (bind (const url)
                                (string urlToFetch))
                          (optional (bind (const params)
                                          (list (repeat (use RequestParameter))))) 
                          (optional (bind (const enccharset) 
                                          (string urlEncCharset)))
                          (optional (bind (const headers)
                                          (use Headers)))))

  
  RequestParameter = (bind (string paramName)
                           (choice (string paramValue)
                                   (int paramValue)
                                   (boolean paramValue)
                                   (list (string mimeType)
                                         (bytes data))))  

Code example

Archived:Example Http Service on WidSets

See also

This page was last modified on 29 June 2012, at 08:44.
70 page views in the last 30 days.