Proxy Configuration

If you're writing an application that runs in a Web Browser (such as a Javascript application) and your application is hosted on a different server to the Cortex API, your requests will be unsuccessful due to the Web Browser's Same Origin Policy. In this case, you will need to set up a proxy server to handle requests between Cortex and your client application. To do this you will need to configure the proxy server to rewrite links to the proxy's address. We suggest using Apache HTTP Server 2.4 as a proxy server.

Rewriting Link URLs

Cortex uses it's server base URL for links in JSON responses. For example, if a Cortex server is deployed at http://api.elasticpath.net/cortex, JSON responses would have the following base URLs:

GET http://api.elasticpath.net/cortex/carts/mobee/default

{
  "self": {
    "type": "elasticpath.carts.cart",
    "uri": "/commerce-legacy/carts/mobee/mq4=",
    "href": "http://api.elasticpath.net/cortex/carts/mobee/mq4=",
    "max-age": 0
  },
  "total-quantity": 3,
  "links": [
    {
      "rel": "lineitems",
      "rev": "cart",
      "type": "application/vnd.elasticpath.links",
      "uri": "/commerce-legacy/carts/mobee/mq4=/lineitems",
      "href": "http://api.elasticpath.net/cortex/carts/mobee/mq4=/lineitems"
    },
    {
      "rel": "order",
      "rev": "cart",
      "type": "elasticpath.orders.order",
      "uri": "/commerce-legacy/orders/mobee/gjq=",
      "href": "http://api.elasticpath.net/cortex/orders/mobee/gjq="
    },
    {
      "rel": "total",
      "rev": "cart",
      "type": "application/vnd.elasticpath.total",
      "uri": "/commerce-legacy/totals/carts/mobee/mq4=",
      "href": "http://api.elasticpath.net/cortex/totals/carts/mobee/mq4="
    }
  ]
}

However, if your client application is deployed on http://app.myhost.net/app, API requests outside of this domain will fail due to the Web Browser's Same Origin Policy. Using a proxy server and the X-Forwarded-Base header for link rewriting, the response can be rewritten to appear as if it's coming from the same server. This works around the Same Origin Policy restriction:

GET http://api.elasticpath.net/cortex/carts/mobee/default
X-Forwarded-Base: http://app.myhost.net/app

{
  "self": {
    "type": "elasticpath.carts.cart",
    "uri": "/commerce-legacy/carts/mobee/mq4=",
    "href": "http://app.myhost.net/app/carts/mobee/mq4=",
    "max-age": 0
  },
  "total-quantity": 3,
  "links": [
    {
      "rel": "lineitems",
      "rev": "cart",
      "type": "application/vnd.elasticpath.links",
      "uri": "/commerce-legacy/carts/mobee/mq4=/lineitems",
      "href": "http://app.myhost.net/app/carts/mobee/mq4=/lineitems"
    },
    {
      "rel": "order",
      "rev": "cart",
      "type": "elasticpath.orders.order",
      "uri": "/commerce-legacy/orders/mobee/gjq=",
      "href": "http://app.myhost.net/app/orders/mobee/gjq="
    },
    {
      "rel": "total",
      "rev": "cart",
      "type": "application/vnd.elasticpath.total",
      "uri": "/commerce-legacy/totals/carts/mobee/mq4=",
      "href": "http://app.myhost.net/app/totals/carts/mobee/mq4="
    }
  ]
}