【背景】
折腾：
过程中，想要试试ResponseGroup的Small。
【折腾过程】
完整代码：
（1）ItemLookupSample.cs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 | /********************************************************************************************** * Copyright 2009 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file * except in compliance with the License. A copy of the License is located at * * * or in the "LICENSE.txt" file accompanying this file. This file is distributed on an "AS IS" * BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations under the License. * * ******************************************************************************************** * * Amazon Product Advertising API * Signed Requests Sample Code * * API Version: 2009-03-31 * */using System;using System.Collections.Generic;using System.Text;using System.Net;using System.IO;using System.Xml;using System.Xml.XPath;namespace AmazonProductAdvtApi{ class ItemLookupSample { private const string awsAccessKeyId = "xxx"; private const string awsSecretKey = "xxx"; private const string awsAssociateTag = "xxx"; private const string awsDestination = "ecs.amazonaws.com"; private const string awsApiVersion = "2011-08-02"; //private const string NAMESPACE = "http://webservices.amazon.com/AWSECommerceService/2009-03-31"; //private const string NAMESPACE = "http://webservices.amazon.com/AWSECommerceService/2011-08-01"; private const string NAMESPACE = "http://webservices.amazon.com/AWSECommerceService/" + awsApiVersion; private const string ITEM_ID = "0545010225"; //private const string ITEM_ID = "B0083PWAPW"; //<Item> // <ASIN>B0083PWAPW</ASIN> // <ParentASIN>B008GGCAVM</ParentASIN> //</Item> //private const string ITEM_ID = "B008GGCAVM"; public static void Main() { SignedRequestHelper helper = new SignedRequestHelper(awsAccessKeyId, awsSecretKey, awsAssociateTag, awsDestination); /* * Here is an ItemLookup example where the request is stored as a dictionary. */ IDictionary<string, string> reqDict = new Dictionary<string, String>(); reqDict["Service"] = "AWSECommerceService"; //r1["Version"] = "2009-03-31"; //r1["Version"] = "2009-03-31"; reqDict["Version"] = "2011-08-02"; reqDict["Operation"] = "ItemLookup"; reqDict["IdType"] = "ASIN"; reqDict["ItemId"] = ITEM_ID; reqDict["ResponseGroup"] = "Small"; //reqDict["ResponseGroup"] = "OfferSummary"; //reqDict["ResponseGroup"] = "ItemAttributes"; //reqDict["ResponseGroup"] = "VariationSummary"; //reqDict["ResponseGroup"] = "Variations"; /* * The helper supports two forms of requests - dictionary form and query string form. */ String requestUrl; String title; requestUrl = helper.Sign(reqDict); title = FetchTitle(requestUrl); System.Console.WriteLine("Method 1: ItemLookup Dictionary form."); System.Console.WriteLine("Title is \"" + title + "\""); System.Console.WriteLine(); } private static string FetchTitle(string url) { try { WebRequest request = HttpWebRequest.Create(url); WebResponse response = request.GetResponse(); XmlDocument doc = new XmlDocument(); doc.Load(response.GetResponseStream()); //for debug System.Console.WriteLine(doc.InnerXml); XmlNodeList errorMessageNodes = doc.GetElementsByTagName("Message", NAMESPACE); if (errorMessageNodes != null && errorMessageNodes.Count > 0) { String message = errorMessageNodes.Item(0).InnerText; return "Error: " + message + " (but signature worked)"; } XmlNode titleNode = doc.GetElementsByTagName("Title", NAMESPACE).Item(0); string title = titleNode.InnerText; return title; } catch (Exception e) { System.Console.WriteLine("Caught Exception: " + e.Message); System.Console.WriteLine("Stack Trace: " + e.StackTrace); } return null; } }} |
（2）SignedRequestHelper.cs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 | /********************************************************************************************** * Copyright 2009 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file * except in compliance with the License. A copy of the License is located at * * * or in the "LICENSE.txt" file accompanying this file. This file is distributed on an "AS IS" * BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations under the License. * * ******************************************************************************************** * * Amazon Product Advertising API * Signed Requests Sample Code * * API Version: 2009-03-31 * */using System;using System.Collections.Generic;using System.Text;using System.Web;using System.Security.Cryptography;namespace AmazonProductAdvtApi{ class SignedRequestHelper { private string endPoint; private string akid; //added by Crifan Li //Product Advertising API Change Details //Associate Tag Parameter: Every request made to the API should include a valid Associate Tag. Any request that does not contain a valid Associate Tag will be rejected with an appropriate error message. For details on the Associate Tag parameter, please refer to our Developer guide. //-> must add this Associate Tag, otherwise will return: //<Error> // <Code>AWS.MissingParameters</Code> // <Message>Your request is missing required parameters. Required parameters include AssociateTag.</Message> //</Error> private string associateTag; private byte[] secret; private HMAC signer; private const string REQUEST_URI = "/onca/xml"; private const string REQUEST_METHOD = "GET"; /* * Use this constructor to create the object. The AWS credentials are available on * * The destination is the service end-point for your application: * US: ecs.amazonaws.com * JP: ecs.amazonaws.jp * UK: ecs.amazonaws.co.uk * DE: ecs.amazonaws.de * FR: ecs.amazonaws.fr * CA: ecs.amazonaws.ca */ public SignedRequestHelper(string awsAccessKeyId, string awsSecretKey, string awsAssociateTag, string destination) { this.endPoint = destination.ToLower(); this.akid = awsAccessKeyId; //added by Crifan Li this.associateTag = awsAssociateTag; this.secret = Encoding.UTF8.GetBytes(awsSecretKey); this.signer = new HMACSHA256(this.secret); } /* * Sign a request in the form of a Dictionary of name-value pairs. * * This method returns a complete URL to use. Modifying the returned URL * in any way invalidates the signature and Amazon will reject the requests. */ public string Sign(IDictionary<string, string> request) { // Use a SortedDictionary to get the parameters in naturual byte order, as // required by AWS. ParamComparer pc = new ParamComparer(); SortedDictionary<string, string> sortedMap = new SortedDictionary<string, string>(request, pc); // Add the AWSAccessKeyId and Timestamp to the requests. sortedMap["AWSAccessKeyId"] = this.akid; //added by Crifan Li sortedMap["AssociateTag"] = this.associateTag; sortedMap["Timestamp"] = this.GetTimestamp(); // Get the canonical query string string canonicalQS = this.ConstructCanonicalQueryString(sortedMap); // Derive the bytes needs to be signed. StringBuilder builder = new StringBuilder(); builder.Append(REQUEST_METHOD) .Append("\n") .Append(this.endPoint) .Append("\n") .Append(REQUEST_URI) .Append("\n") .Append(canonicalQS); string stringToSign = builder.ToString(); byte[] toSign = Encoding.UTF8.GetBytes(stringToSign); // Compute the signature and convert to Base64. byte[] sigBytes = signer.ComputeHash(toSign); string signature = Convert.ToBase64String(sigBytes); // now construct the complete URL and return to caller. StringBuilder qsBuilder = new StringBuilder(); .Append(this.endPoint) .Append(REQUEST_URI) .Append("?") .Append(canonicalQS) .Append("&Signature=") .Append(this.PercentEncodeRfc3986(signature)); return qsBuilder.ToString(); } /* * Sign a request in the form of a query string. * * This method returns a complete URL to use. Modifying the returned URL * in any way invalidates the signature and Amazon will reject the requests. */ public string Sign(string queryString) { IDictionary<string, string> request = this.CreateDictionary(queryString); return this.Sign(request); } /* * Current time in IS0 8601 format as required by Amazon */ private string GetTimestamp() { DateTime currentTime = DateTime.UtcNow; string timestamp = currentTime.ToString("yyyy-MM-ddTHH:mm:ssZ"); return timestamp; } /* * Percent-encode (URL Encode) according to RFC 3986 as required by Amazon. * * This is necessary because .NET's HttpUtility.UrlEncode does not encode * according to the above standard. Also, .NET returns lower-case encoding * by default and Amazon requires upper-case encoding. */ private string PercentEncodeRfc3986(string str) { str = HttpUtility.UrlEncode(str, System.Text.Encoding.UTF8); str = str.Replace("'", "%27").Replace("(", "%28").Replace(")", "%29").Replace("*", "%2A").Replace("!", "%21").Replace("%7e", "~").Replace("+", "%20"); StringBuilder sbuilder = new StringBuilder(str); for (int i = 0; i < sbuilder.Length; i++) { if (sbuilder[i] == '%') { if (Char.IsLetter(sbuilder[i + 1]) || Char.IsLetter(sbuilder[i + 2])) { sbuilder[i + 1] = Char.ToUpper(sbuilder[i + 1]); sbuilder[i + 2] = Char.ToUpper(sbuilder[i + 2]); } } } return sbuilder.ToString(); } /* * Convert a query string to corresponding dictionary of name-value pairs. */ private IDictionary<string, string> CreateDictionary(string queryString) { Dictionary<string, string> map = new Dictionary<string, string>(); string[] requestParams = queryString.Split('&'); for (int i = 0; i < requestParams.Length; i++) { if (requestParams[i].Length < 1) { continue; } char[] sep = { '=' }; string[] param = requestParams[i].Split(sep, 2); for (int j = 0; j < param.Length; j++) { param[j] = HttpUtility.UrlDecode(param[j], System.Text.Encoding.UTF8); } switch (param.Length) { case 1: { if (requestParams[i].Length >= 1) { if (requestParams[i].ToCharArray()[0] == '=') { map[""] = param[0]; } else { map[param[0]] = ""; } } break; } case 2: { if (!string.IsNullOrEmpty(param[0])) { map[param[0]] = param[1]; } } break; } } return map; } /* * Consttuct the canonical query string from the sorted parameter map. */ private string ConstructCanonicalQueryString(SortedDictionary<string, string> sortedParamMap) { StringBuilder builder = new StringBuilder(); if (sortedParamMap.Count == 0) { builder.Append(""); return builder.ToString(); } foreach (KeyValuePair<string, string> kvp in sortedParamMap) { builder.Append(this.PercentEncodeRfc3986(kvp.Key)); builder.Append("="); builder.Append(this.PercentEncodeRfc3986(kvp.Value)); builder.Append("&"); } string canonicalString = builder.ToString(); canonicalString = canonicalString.Substring(0, canonicalString.Length - 1); return canonicalString; } } /* * To help the SortedDictionary order the name-value pairs in the correct way. */ class ParamComparer : IComparer<string> { public int Compare(string p1, string p2) { return string.CompareOrdinal(p1, p2); } }} |
调试可以得到返回的xml：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | <?xml version="1.0"?> <OperationRequest> <RequestId>7b3a518d-575b-43ce-b80a-e15d094f1261</RequestId> <Arguments> <Argument Name="Operation" Value="ItemLookup"/> <Argument Name="Service" Value="AWSECommerceService"/> <Argument Name="Signature" Value="HaQH/KKICqtNf7WMS18LkhB0Rc1EwDQlNDXYURorJAg="/> <Argument Name="AssociateTag" Value="xxx"/> <Argument Name="Version" Value="2011-08-02"/> <Argument Name="ItemId" Value="0545010225"/> <Argument Name="IdType" Value="ASIN"/> <Argument Name="AWSAccessKeyId" Value="xxx"/> <Argument Name="Timestamp" Value="2013-06-13T08:56:20Z"/> <Argument Name="ResponseGroup" Value="Small"/> </Arguments> <RequestProcessingTime>0.0102710000000000</RequestProcessingTime> </OperationRequest> <Items> <Request> <IsValid>True</IsValid> <ItemLookupRequest> <IdType>ASIN</IdType> <ItemId>0545010225</ItemId> <ResponseGroup>Small</ResponseGroup> <VariationPage>All</VariationPage> </ItemLookupRequest> </Request> <Item> <ASIN>0545010225</ASIN> <DetailPageURL>http://www.amazon.com/Harry-Potter-Deathly-Hallows-Book/dp/0545010225%3FSubscriptionId%3Dxxx%26tag%3Dxxx%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3D0545010225</DetailPageURL> <ItemLinks> <ItemLink> <Description>Technical Details</Description> </ItemLink> <ItemLink> <Description>Add To Baby Registry</Description> </ItemLink> <ItemLink> <Description>Add To Wedding Registry</Description> </ItemLink> <ItemLink> <Description>Add To Wishlist</Description> </ItemLink> <ItemLink> <Description>Tell A Friend</Description> </ItemLink> <ItemLink> <Description>All Customer Reviews</Description> </ItemLink> <ItemLink> <Description>All Offers</Description> </ItemLink> </ItemLinks> <ItemAttributes> <Author>J. K. Rowling</Author> <Creator Role="Illustrator">Mary GrandPré</Creator> <Manufacturer>Arthur A. Levine Books</Manufacturer> <ProductGroup>Book</ProductGroup> <Title>Harry Potter and the Deathly Hallows (Book 7)</Title> </ItemAttributes> </Item> </Items></ItemLookupResponse> |
【总结】
通过ResponseGroup的Small，可以返回基本的信息。
更多内容可参考：
相关参考：
【整理】C#版的AWS的ResponseGroup的OfferSummary示例代码
【整理】C#版的AWS的ResponseGroup的ItemAttributes示例代码
【整理】C#版的AWS的ResponseGroup的VariationSummary示例代码