• Register

Global Ad Media 2.0

Description

The Global Ad Media Service is a read only resource that returns all the media information for a known list of global header and footer pool names.

HTTP Method and Request URL

GET

https://api.bloomingdales.com/v2/admedia/global?poolName=GLOBALFOOTER%2CABOVE_NAV_POOL

Path and Query Parameters

HTTP Header Parameters

Parameter

Description

Mandatory

Sample Value

Accept

Specifies the output format. Can be application/json or application/xml.

Yes

application/json

application/xml

x-macys-webservice-client-id

Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. Click here for a list of your API keys.

Yes

x-macys-webservice-client-id:xmj9js4jkdpe1983fmwu98gh

Query Parameters

Parameter

Description

Mandatory

Sample Value

poolName

Specify one or more pool names separated by comma.

Yes
poolName=GLOBALFOOTER

strict


If (strict=true), and if there is no data found for any given poolName then an exception will be thrown.
Yes
true or false
secure By default this is set to false. If set to true links in response will be https NOT http No
true or false
callback If sent, the format is JSONP (JSON with Padding) with the callback returned with the JSON response. You can put anything in the callback parameter and whatever you send is returned.  No
magicofmacysapi

back to top

Sample Request and Response

Sample Request

Request URL:

GET

https://api.bloomingdales.com/v2/admedia/global?poolName=GLOBALFOOTER%2CABOVE_NAV_POOL

HTTP Header:

Accept: application/json

X-Macys-Webservice-Client-Id: vregqrxzxd9ge5wnvmqg2ca7

X-Originating-Ip: 12.345.67.8

Sample Request

{
    "mediaPoolMapper": {
        "mediaPoolItem": [{
            "poolName": "ABOVE_NAV_POOL",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "javascript:pop('/popup.ognc?popupID=23133&cm_sp=NAVIGATION-_-GLOBAL_BANNER-_-FREE_SHIPPING','myDynaPop','width=575,height=350')",
                            "fullLinkURL": "javascript:pop('/popup.ognc?popupID=23133&cm_sp=NAVIGATION-_-GLOBAL_BANNER-_-FREE_SHIPPING','myDynaPop','width=575,height=350')"
                        }]
                    },
                    "filename": "0311_ongoing_global.swf",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/site_ad/0311_ongoing_global.swf",
                    "height": 30,
                    "width": 375,
                    "text": "",
                    "description": "03112013_global_ongoing",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "508744"
                }]
            }
        }]
    },
    "errors": [{
        "errorCode": 409,
        "message": "No data for search criteria",
        "errorDetail": ["No global media data found for the poolName"],
        "success": false,
        "poolname": "GLOBALFOOTER"
    }]
}

back to top

Error Codes

Call Specific Error Codes:

           {
                     "errorCode"409
                     "No data for search criteria"
                     "errorDetail"
                     "No global media data found for the search criteria"
                     "success"false>
               } 

General Error Handling Documentation:

Click Here

back to top

Docs Navigation