Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Simple Gilt Java API (v1) library

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 dist
Octocat-spinner-32 doc
Octocat-spinner-32 src
Octocat-spinner-32 .gitignore
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 build.xml
Octocat-spinner-32 ivy.xml
README.md

Gilt-Java

A simple (unofficial) Java client library for the Gilt API(v1). Currently this provides basic support for fetching current and upcoming sales. gilt-java has minimal dependencies and is aimed to be easy to use.

Android

Android platform to be tested soon!

Download Latest

Download the latest jar here

Build & Use

Please check Gilt API documentation for the official API descriptions and to get your private API key (required for use). To build:

$ ant

Examples:

GiltAPI gilt = new GiltAPIClient(API_KEY);

// Get active sales for all Gilt stores
gilt.getActiveSales();

// Get active sales for the Kids store
gilt.getActiveSales(Store.KIDS);

// Get upcoming sales for all Gilt stores
gilt.getUpcomingSales();

// Get upcoming sales for the Womens store
gilt.getUpcomingSales(Store.WOMEN);

// Get sale details for specific sale
gilt.getSaleDetails(sale.getStoreKey(), sale.getSaleKey());

// Get product details for specific product id
gilt.getProductDetails(productId);

// Get all available product categories
gilt.getProductCategories();

NOTE: gilt-java includes software from codehaus.org & testng.org.

TODO

  • Ensure that all the data available via Gilt API is accessible
  • Return timestamps as java.sql.Timestamp instead of java.lang.String
  • Convert store key to enums

Contribute

Submit well documented code with unit tests and I will merge your changes in as long as your code does not break the build.

Gilt API Endpoints

Currently there are 2 API endpoints available:

  • Base Url

  • Sales Endpoint

    • sales/active.json => List<Sale> getActiveSales()
    • sales/{store_key}/active.json => List<Sale> getActiveSales(String storeKey)
    • sales/upcoming.json => List<Sale> getUpcomingSales()
    • sales/{store_key}/upcoming.json => List<Sale> getUpcomingSales(String storeKey)
    • sales/{store_key}/{sale_key}/detail.json => List<Sale> getSaleDetails(String storeKey, String saleKey)
  • Products Endpoint

    • products/{product_id}/detail.json => Product getProductDetails(int productId)
    • products/categories.json => List<String> getProductCategories()

Copyright

Copyright (c) 2013 Nitin Dhar. See MIT-LICENSE for details.

Author

My aim is to make Forrst integration into Java applications as easy as possible. I have tried my best to provide in-code documentation for each method.

Something went wrong with that request. Please try again.