Amazon DevPay
Developer Guide (API Version 2007-12-01)

REST-Query Requests

The License Service supports REST-Query requests for calling service actions. REST-Query is also commonly known as Query or HTTP Query. REST-Query requests are simple HTTPS requests, using the GET or POST method with query parameters in the URL. REST-Query requests must contain an Action parameter to indicate the action to be performed. The response is an XML document that conforms to the License Service WSDL. You might use REST-Query requests when a SOAP toolkit is not available for your platform, or when REST-Query requests are easier to make than a heavier SOAP equivalent.


The REST-Query requests your product creates to call the License Service are not the same as the REST requests the product creates to call the Amazon Simple Storage Service. Although they are both HTTP requests, the Amazon S3 REST requests use additional HTTP methods (such as DELETE) and HTTP headers. Make sure your product follows the instructions here for forming REST-Query requests when calling the License Service.


All requests to the License Service must be made using HTTPS. HTTP requests are not accepted.

Structure of a REST-Query Request

REST-Query requests are URLs. The following is an example REST-Query request to ActivateHostedProduct .​&ActivationKey=ADMAY7DVLJTWHJ76MMBMQEXAMPLE​&ProductToken={ProductToken}AAAHVXNlclRrbgfOpSykBA....[long encoded token]...&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE​&Version=2008-04-28​&Timestamp=2008-05-19T12:00:00Z​&Signature=lB/P67vCvGlDMBQ1dofZxg8E8SUEXAMPLE=

Because the preceding format is hard to read, all REST-Query examples in this guide are presented in the following format.
&ProductToken={ProductToken}AAAHVXNlclRrbgfOpSykBA....[long encoded token]...

The first line represents the endpoint of the request. This is the resource the request acts on. This will always be for the License Service requests.

After the endpoint is a question mark (?), which separates the endpoint from the parameters. Each parameter is separated by an ampersand (&).

The Action parameter indicates the action to perform on the requested endpoint. The actions correspond to the License Service API actions.

Each action uses additional parameters, and they are listed in the topic for each action.


Because REST-Query requests are URLs, you must URL encode the parameter values.