| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
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.
Important
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.
Important
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
.
https://ls.amazonaws.com/?Action=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.
https://ls.amazonaws.com/
?Action=ActivateHostedProduct
&ActivationKey=ADMAY7DVLJTWHJ76MMBMQEXAMPLE
&ProductToken={ProductToken}AAAHVXNlclRrbgfOpSykBA....[long encoded token]...
&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&Version=2008-04-28
&Timestamp=2008-05-19T12:00:00Z
&Signature=lB/P67vCvGlDMBQ1dofZxg8E8SUEXAMPLE=
&SignatureVersion=1The first line represents the endpoint of the request. This is the
resource the request acts on. This will always be https://ls.amazonaws.com/ 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.
Important
Because REST-Query requests are URLs, you must URL encode the parameter values.
Related Topics
