$ bundle install

$ gem install catalogapi

CatalogAPI.key         = 'test-key'    # provided by CatalogAPI.com
CatalogAPI.token       = 'test-token'  # provided by CatalogAPI.com
CatalogAPI.environment = 'development' # or production, default is development
CatalogAPI.username    = 'username'    # provided by CatalogAPI.com (subdomain)

CatalogAPI::Catalog.list_available.data
=> [
  #<CatalogAPI::Catalog @currency="USD", @export_uri=...,
  #<CatalogAPI::Catalog @currency="USD", @export_uri=...,
]

CatalogAPI::Catalog.new(socket_id: '123').breakdown.data
=> [
  #<CatalogAPI::Category
    @category_id="99",
    @children=[#<CatalogAPI::Category @category_id="11"...>],
    ...
  >,
  ...
]

CatalogAPI::Catalog.new(socket_id: '123').search(search: 'ipod').data
=> [
  #<CatalogAPI::Item
    @brand="Apple",
    @catalog_item_id=1234
    ...
  >,
  ...
]

CatalogAPI::Item.new(catalog_item_id: 1, socket_id: 2).view.data
=> #<CatalogAPI::Item
  ...
  @catalog_item_id="1",
  ...
  @description=
  ...
>

CatalogAPI::Order.list(external_user_id).data
=> [
  #<CatalogAPI::Order
    external_user_id=1
    ...
  >,
  ...
]

CatalogAPI::Order.new(
  items: CatalogAPI::Item.new,
  first_name: "Test",
  last_name: "Testman",
  address_1: "123 Test Street",
  city: "Cincinnati",
  state_province: "OH",
  postal_code: "00000",
  country: "US"
).place.data
=> #<CatalogAPI::Order @order_number="XXXX-XXXXX-XXXXX-XXXX" ...>

CatalogAPI::Order.new(order_number: '4004-20883-04361-0098').track.data
=> #<CatalogAPI::Item:0x00007f92d6430948 @order_number="4004-20883-04361-0098" ...>