=====[ ShopBlast API DOCS ]=====

* * * * 
    * Request API access token: https://www.ShockBlast.net/contact/
* * * *

To make an API request, you must prefix the url with https://x.ShockBlast.net/api/shop/ and send your API token as a parameter.
All request/response formats are JSON.



+ GET:
    GET /api/shop/?token=APITOKEN&sortby=pop
    HOST https://x.ShockBlast.net
    

+ POST:
    POST not supported.



+ Authentication: (you need an api key in order to connect to the api)
	?token=PyezS3Q4Smivb24d9SzZGYSuh--IaMfAkE

+ API RATE LIMIT:
    - Since version 1.2 we introduced an API RATE LIMIT, to encourage you to cache the results and serve a cached version.
    - You have; 5 requests for a time window of 30 minutes.

+ Request Parameters:

	+ Number of products to get: (max number of products you can get; 20) / default: 10
		&limit=10

	+ Category of products to get: (ID of the category you want to retrive products from) / default: all
            - Accessories = 38, 
            - Apparel = 211, 
            - Apps = 2, 
            - Cool Things = 40, 
            - Electronics = 41, 
            - Entertainment = 39, 
            - Home & Office = 29, 
            - ShockBlast Originals = 217, 
            - Stuff to Read = 24
                &cat=2

	+ Image size to get: (Squared: smallsq, mediumsq | Not Squared: small, medium, large, full) / defaul: smallsq
		&img=medium

	+ Order of products to get: (ASC, DESC) / default: DESC
		&ord=ASC

        + Get list of Most Popular products: / default: null
                &sortby=pop

        + Search for products
                &search=Apple


	+ Callback response: (To use JSONP, append callback= and the name of your callback function to the request.) / default: JSON
		&callback

        - also works:
                &callback=whatever

+ Example:
	http://x.ShockBlast.net/api/shop/?token=PyezS3Q4Smivb24d9SzZGYSuh--IaMfAkE&limit=4&cat=2&img=medium&ord=ASC

+ Response:

{
    "meta": {
        "status": 200,
        "msg": "OK",
        "ver": "1.2"
    }, 
    "shop": {
        "products": [ {
                "id": 289,
                "rank": "0",
                "name": "Keynote x iOS",
                "currency": "€",
                "price": "10",
                "category": "apps",
                "tag": "ios",
                "brand": "apple",
                "url": 
                {

                    "page": "https://www.shockblast.net/shop/prod/289/?utm_source=api&utm_medium=store_api&utm_campaign=ShopBlast",
                    "buy": "http://s.shck.it/1JkCssI"

                },
                "image": 

                    {
                        "url": "https://www.shockblast.net/shop/media/2015/08/Keynote-app-ios-ShockBlast-550x550.png",
                        "width": "550",
                        "height": "550"
                    }

            },
            {
                "id": 94,
                "rank": "0",
                "name": "Pixelmator x iOS",
                "currency": "€",
                "price": "5",
                "category": "apps",
                "tag": "ios",
                "brand": null,
                "url": 
                {

                    "page": "https://www.shockblast.net/shop/prod/94/?utm_source=api&utm_medium=store_api&utm_campaign=ShopBlast",
                    "buy": "http://s.shck.it/1DYo8ds"

                },
                "image": 

                    {
                        "url": "https://www.shockblast.net/shop/media/2015/08/pixelmator-icon-ShockBlast-550x550.png",
                        "width": "550",
                        "height": "550"
                    }

            },
            {
                "id": 105,
                "rank": "0",
                "name": "Enlight x iOS",
                "currency": "€",
                "price": "5",
                "category": "apps",
                "tag": "ios",
                "brand": "Lightricks",
                "url": 
                {

                    "page": "https://www.shockblast.net/shop/prod/105/?utm_source=api&utm_medium=store_api&utm_campaign=ShopBlast",
                    "buy": "http://s.shck.it/1E0umJW"

                },
                "image": 

                    {
                        "url": "https://www.shockblast.net/shop/media/2015/08/enlight-logo-181735-ShockBlast-550x413.png",
                        "width": "550",
                        "height": "413"
                    }

            },
            {
                "id": 127,
                "rank": "0",
                "name": "Mextures x iOS",
                "currency": "€",
                "price": "2",
                "category": "apps",
                "tag": "ios",
                "brand": null,
                "url": 
                {

                    "page": "https://www.shockblast.net/shop/prod/127/?utm_source=api&utm_medium=store_api&utm_campaign=ShopBlast",
                    "buy": "http://s.shck.it/1Jcu7rc"

                },
                "image": 

                    {
                        "url": "https://www.shockblast.net/shop/media/2015/08/White-Logo-129449-ShockBlast-550x541.jpg",
                        "width": "550",
                        "height": "541"
                    }

                }
        ]
    }
}


=====[ C H A N G E  L O G ]=====


+ v1.0 (august 2015)
    - hello world

+ v1.1 (14 august 2015)
    - Added "Product Popularity Rank Number" > rank
    - Added URL to product page > page
    - Added sort by "most popular" get with > &sortby=pop

+ v1.2 (28 august 2015)
    - Introduced an API Rate Limit > 5 requests for time window of 30 minutes.

+ v1.3 (18 september 2015)
    - fixed & updated buy urls bug


+ v1.4 (25 february 2016)
    - Added "Product search" > search
    - fixes & updates