Blog de Jérémie Bertrand » Amazon https://blog.developpez.com/laedit Tue, 22 Mar 2011 14:30:08 +0000 fr-FR hourly 1 https://wordpress.org/?v=4.1.42 Amazon Product Advertising API en C# https://blog.developpez.com/laedit/p9187/c/amazon_product_advertising_api_en_c https://blog.developpez.com/laedit/p9187/c/amazon_product_advertising_api_en_c#comments Sat, 07 Aug 2010 18:37:34 +0000 Avez-vous déjà voulu requêter les web services d’amazon afin de récupérer le titre d’un film ou d’un livre ?

Si oui, vous vous êtes sûrement déjà confrontés au brouillard de tous les web services amazon afin de trouver le bon, et après il faut encore trouver son nom ( car ils ont tendance à changer ) et à trouver quelques bons exemples de codes encore valable, voire la bonne adresse du WSDL.

Après une petite après-midi de recherche, j’ai pu trouver ce que je voulais et arriver au résultat voulu : récupérer toutes les informations d’un produit à partir de son code EAN (code-barre).

Après avoir passé quelques heures sur le site d’amazon et m’être aperçu que tous les exemples ne sont plus valable, je me suis tourné vers google. Et après quelques recherches infructueuses, j’ai trouvé la perle : le code-source et le guide pour réaliser le même code.

Merci Oren Trutner : https://flyingpies.wordpress.com/2009/08/01/17/

Au passage, il faut se créer un compte pour utiliser les web services d’Amazon. Vous pouvez vous en créer un gratuitement à cette adresse : http://aws.amazon.com/ en cliquant sur le lient « Create an AWS Account » en haut à droite. Une fois la création effectuée, allez dans Account->Security Credentials et gardez sous la main l’Access Key ID et la Secret Access Key dans la partie Access Credentials, vous en aurez besoin par la suite.

Au niveau du code, au début rien de bien compliqué : le WSDL est dispo à l’adresse http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl.
Il suffit de créer une nouveau projet dans Visual Studio et d’ajouter une référence de service avec cette uri, en asynchrone ou non selon vos goûts.
On obtient donc de jolies classes de proxy, que l’on peut donc utiliser afin de requêter Amazon.

    class Program
    {
        // your Amazon ID's
        private const string accessKeyId = "AccessKeyId";
        private const string secretKey = "SecretAccessKey";
 
        // the program starts here
        static void Main(string[] args)
        {
 
            // create a WCF Amazon ECS client
            AWSECommerceServicePortTypeClient client = new AWSECommerceServicePortTypeClient(
                new BasicHttpBinding(),
                new EndpointAddress("http://webservices.amazon.com/onca/soap?Service=AWSECommerceService"));
 
            // prepare an ItemSearch request
            ItemSearchRequest request = new ItemSearchRequest();
            request.SearchIndex = "All";
            request.Keywords = "3700259800655";
            request.ResponseGroup = new String[] { "Large" };
             
            ItemSearch itemSearch = new ItemSearch();
            itemSearch.Request = new ItemSearchRequest[] { request };
            itemSearch.AWSAccessKeyId = accessKeyId;
 
            // issue the ItemSearch request
            ItemSearchResponse response = client.ItemSearch(itemSearch);
 
            // write out the results
            foreach (var item in response.Items[0].Item)
            {
                Console.WriteLine(item.ItemAttributes.Title);
            }
 
            Console.ReadLine();

Pour information, la liste de tous les SearchIndex est ici : http://docs.amazonwebservices.com/AWSEcommerceService/4-0/ApiReference/SearchIndexValues.html. Il faut tout de même lui ajouter All, qui correspond à une recherche sur toutes les catégories.

Mais le code précédent ne fonctionne pas. Pas avant d’avoir bidouillé un peu. Car ce qu’Amazon ne dit pas sur son site (ou alors il fallait chercher pendant encore quelques heures), c’est toute la partie authentification des messages SOAP qu’il faut mettre en place.
Trois classes vont rendre cela possible :

  • AmazonSigningMessageInspector : implémente IClientMessageInspector et permet de modifier la requête avant son envoi. Elle va donc rajouter les headers.
  • AmazonSigningEndpointBehavior : implémente IEndpointBehavior et permet d’ajouter le bon MessageInspector au bon moment.
  • AmazonHeader : hérite de MessageHeader et est utilisée par le MessageInspector pour ajouter les headers.

Voilà la partie du code de AmazonSigningMessageInspector ajoutant les headers :

        public object BeforeSendRequest(ref Message request, IClientChannel channel)
        {
            // prepare the data to sign
            string operation = Regex.Match(request.Headers.Action, "[^/]+$").ToString();
            DateTime now = DateTime.UtcNow;
            string timestamp = now.ToString("yyyy-MM-ddTHH:mm:ssZ");
            string signMe = operation + timestamp;
            byte[] bytesToSign = Encoding.UTF8.GetBytes(signMe);
 
            // sign the data
            byte[] secretKeyBytes = Encoding.UTF8.GetBytes(secretKey);
            HMAC hmacSha256 = new HMACSHA256(secretKeyBytes);
            byte[] hashBytes = hmacSha256.ComputeHash(bytesToSign);
            string signature = Convert.ToBase64String(hashBytes);
 
            // add the signature information to the request headers
            request.Headers.Add(new AmazonHeader("AWSAccessKeyId", accessKeyId));
            request.Headers.Add(new AmazonHeader("Timestamp", timestamp));
            request.Headers.Add(new AmazonHeader("Signature", signature));
 
            return null;
        }

Cela permettra de mettre en place un header de ce type :

<soap:Header
   xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/">
   <aws:AWSAccessKeyId>YOURACCESSKEYIDHEREX</aws:AWSAccessKeyId>
   <aws:Timestamp>2009-08-15T23:59:59Z</aws:Timestamp>
   <aws:Signature>SZf1CHmQnrZbsrC13hCZS061ywsEXAMPLE</aws:Signature>
</soap:Header>

Il suffit ensuite de modifier la façon d’appeler le web service pour que tout roule :

            // create a WCF Amazon ECS client
            BasicHttpBinding binding = new BasicHttpBinding(BasicHttpSecurityMode.Transport);
            binding.MaxReceivedMessageSize = int.MaxValue;
            AWSECommerceServicePortTypeClient client = new AWSECommerceServicePortTypeClient(
                binding,
                new EndpointAddress("http://webservices.amazon.com/onca/soap?Service=AWSECommerceService"));
 
            // add authentication to the ECS client
            client.ChannelFactory.Endpoint.Behaviors.Add(new AmazonSigningEndpointBehavior(accessKeyId, secretKey));

Et afin de pouvoir « localiser » les web services, j’ai créée une petite classe AmazonEndpointAdress recensant toutes les adresses des endpoint des web services Amazon, accessibles ici : http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html?AnatomyOfaRESTRequest.html.
Bien entendu, votre fichier App.config doit comporter tous les endpoint correspondant.
Et au final, le code d’appel ressemble à celle-ci :

AWSECommerceServicePortTypeClient client = new AWSECommerceServicePortTypeClient(
                binding,
                new EndpointAddress(AmazonEndpointAdresses.FR));

Et voilà !

Vous pouvez maintenant rechercher n’importe quel produit sur n’importe quel site d’Amazon !

Les sources sont disponibles ici : http://laedit.ftp-developpez.com/CSharp/Amazon/AmazonProductAdvtApiWcfSample.zip.

]]> 0