ProductAPI.Amazon

<back to all web services

PostProductSearchRequest

Requires Authentication
The following routes are available for this service:
POST/v1/search
import Foundation
import ServiceStack

// @DataContract
public class PostProductSearchRequest : PostProductSearchRequestBase, IPostProductSearchRequest
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract
public class PostProductSearchRequestBase : IPostProductSearchRequestBase, Codable
{
    // @DataMember(Name="data")
    // @ApiMember(Name="data")
    public var data:IList<ProductData>

    // @DataMember(Name="timeoutMs")
    // @ApiMember(Name="timeoutMs")
    public var timeoutMs:UInt32

    // @DataMember(Name="maxStaleness")
    // @ApiMember(Name="maxStaleness")
    public var maxStaleness:UInt64

    // @DataMember(Name="countryIso2s")
    // @ApiMember(Name="countryIso2s")
    public var countryIso2s:[String]

    // @DataMember(Name="productTypes")
    // @ApiMember(Name="targetProductCategories")
    public var productTypes:[String]

    required public init(){}
}

// @DataContract
public class ProductData : Codable
{
    // @DataMember(Name="attributes", EmitDefaultValue=false)
    public var attributes:ProductAttributes

    // @DataMember(Name="retailerSpecificAttributes", EmitDefaultValue=false)
    public var retailerSpecificAttributes:RetailerSpecificAttributes

    // @DataMember(Name="rawSourceData", EmitDefaultValue=false)
    public var rawSourceData:String

    required public init(){}
}

// @DataContract
public class ProductAttributes : Codable
{
    // @DataMember(Name="retailer", EmitDefaultValue=false)
    public var retailer:String

    // @DataMember(Name="retailerGuid", EmitDefaultValue=false)
    public var retailerGuid:String

    // @DataMember(Name="storefront", EmitDefaultValue=false)
    public var storefront:String

    // @DataMember(Name="storefrontIso2", EmitDefaultValue=false)
    public var storefrontIso2:String

    // @DataMember(Name="storefrontGuid", EmitDefaultValue=false)
    public var storefrontGuid:String

    // @DataMember(Name="category", EmitDefaultValue=false)
    public var category:String

    // @DataMember(Name="categoryGuid", EmitDefaultValue=false)
    public var categoryGuid:String

    // @DataMember(Name="brand", EmitDefaultValue=false)
    public var brand:String

    // @DataMember(Name="brandGuid", EmitDefaultValue=false)
    public var brandGuid:String

    // @DataMember(Name="manufacturer", EmitDefaultValue=false)
    public var manufacturer:String

    // @DataMember(Name="manufacturerGuid", EmitDefaultValue=false)
    public var manufacturerGuid:String

    // @DataMember(Name="identifiers", EmitDefaultValue=false)
    public var identifiers:ProductIdentifiers

    // @DataMember(Name="itemAttributes", EmitDefaultValue=false)
    public var itemAttributes:ItemAttributes

    required public init(){}
}

// @DataContract
public class ProductIdentifiers : Codable
{
    // @DataMember(Name="productGuid", EmitDefaultValue=false)
    public var productGuid:String

    // @DataMember(Name="gtins", EmitDefaultValue=false)
    public var gtins:[String]

    // @DataMember(Name="mpns", EmitDefaultValue=false)
    public var mpns:[String]

    // @DataMember(Name="ean8", EmitDefaultValue=false)
    public var ean8:[String]

    // @DataMember(Name="ean13", EmitDefaultValue=false)
    public var ean13:[String]

    // @DataMember(Name="isbn9", EmitDefaultValue=false)
    public var isbn9:[String]

    // @DataMember(Name="isbn10", EmitDefaultValue=false)
    public var isbn10:[String]

    // @DataMember(Name="isbn13", EmitDefaultValue=false)
    public var isbn13:[String]

    // @DataMember(Name="itf14", EmitDefaultValue=false)
    public var itf14:[String]

    // @DataMember(Name="upc12", EmitDefaultValue=false)
    public var upc12:[String]

    required public init(){}
}

// @DataContract
public class ItemAttributes : Codable
{
    // @DataMember(Name="book", EmitDefaultValue=false)
    public var book:BookAttributes

    // @DataMember(Name="audiobook", EmitDefaultValue=false)
    public var audiobook:AudiobookAttributes

    // @DataMember(Name="ebook", EmitDefaultValue=false)
    public var ebook:EBookAttributes

    required public init(){}
}

// @DataContract
public class BookAttributes : Codable
{
    // @DataMember(Name="authors", EmitDefaultValue=false)
    public var authors:[String]

    required public init(){}
}

// @DataContract
public class AudiobookAttributes : BookAttributes
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract
public class EBookAttributes : BookAttributes
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract
public class RetailerSpecificAttributes : Codable
{
    // @DataMember(Name="name", EmitDefaultValue=false)
    public var name:String

    // @DataMember(Name="description", EmitDefaultValue=false)
    public var description:String

    // @DataMember(Name="skus", EmitDefaultValue=false)
    public var skus:[String]

    // @DataMember(Name="asin", EmitDefaultValue=false)
    public var asin:String

    // @DataMember(Name="url", EmitDefaultValue=false)
    public var url:Uri

    // @DataMember(Name="productImages", EmitDefaultValue=false)
    public var productImages:[String:Uri]

    // @DataMember(Name="additionalData", EmitDefaultValue=false)
    public var additionalData:[String:String]

    required public init(){}
}

// @DataContract
public class PostProductSearchResponse : IPostProductSearchResponse, Codable
{
    // @DataMember(Name="responseStatus")
    public var responseStatus:ResponseStatus

    // @DataMember(Name="matchResults")
    public var matchResults:[MatchResult]

    required public init(){}
}

// @DataContract
public class MatchResult : Codable
{
    // @DataMember(Name="retailer")
    public var retailer:String

    // @DataMember(Name="retailerGuid")
    public var retailerGuid:String

    // @DataMember(Name="storefront")
    public var storefront:String

    // @DataMember(Name="storefrontIso2")
    public var storefrontIso2:String

    // @DataMember(Name="storefrontGuid")
    public var storefrontGuid:String

    // @DataMember(Name="data")
    public var data:ProductData

    // @DataMember(Name="errors")
    public var errors:[MatchError]

    // @DataMember(Name="matchAccuracy")
    public var matchAccuracy:String

    // @DataMember(Name="matchingRuleName")
    public var matchingRuleName:String

    // @DataMember(Name="dataSource")
    public var dataSource:String

    required public init(){}
}

// @DataContract
public class MatchError : Codable
{
    // @DataMember(Name="message")
    public var message:String

    // @DataMember(Name="error")
    public var error:ErrorCode

    required public init(){}
}

public enum ErrorCode : String, Codable
{
    case Throttled
    case TargetRetailerProductNotFound
    case Unknown
    case NullMatchResult
    case NullSourceData
    case SourceDataProcessingFailure
    case LocalizationFailure
}

Swift PostProductSearchRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /v1/search HTTP/1.1 
Host: product-amazon-api.qa.platform.georiot.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PostProductSearchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Amazon.ServiceModel.V1.Requests">
  <countryIso2s xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.Requests">
    <d2p1:string>String</d2p1:string>
  </countryIso2s>
  <data xmlns:d2p1="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.DTOs" i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.Requests" />
  <maxStaleness xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.Requests">0</maxStaleness>
  <productTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.Requests" />
  <timeoutMs xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.Requests">0</timeoutMs>
</PostProductSearchRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<PostProductSearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ProductAPI.Amazon.ServiceModel.V1.Responses">
  <matchResults xmlns:d2p1="http://schemas.datacontract.org/2004/07/ProductAPI.Contracts.V1.DTOs" i:nil="true" />
  <responseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </responseStatus>
</PostProductSearchResponse>