Domain aliases

Note: this API is in beta currently and is subject to change in the future.

Domain aliases

The Domain aliases resource allows creation of alternate URLs for Site objects that can be hosted under a different domain and/or directory. These URLs render a copy of the Site, but can modify certain fields to change their properties.

The most common use of Domain aliases is to create alternate URLs for different languages or language/regions.

Domain alias object

Domain alias model

A domain alias contains the following fields

Attribute	Type	Description
id	integer	unique id of the domain alias
site_id	integer	Reference id to the Site this domain alias is connected to
user_id	integer	Reference id to the User that created this domain alias
deleted	boolean	Field that denotes if the domain alias is disabled or not
base_directory	string	For landing pages, the directory that the domain alias will be published - Default is /
formatted_domain	string	The hostname/domain where the domain alias is published, including the domain and subdomain (i.e www.example.com)
formatted_url	string	Read-only field that formats the domain, base directory and scheme (i.e. https://www.example.com/)
domain	string	The domain part of the formatted_domain (i.e. www.example.com)
preview_url	string	Preview URL for this domain alias. Should always be available regardless of published status
partner_alias_id	string	Unique ID reference to partner IDs
language_code	string	The default language (plus specific region) for the domain alias. Similar to the values that browsers send. Examples: en, en-us
custom_fields	object	Custom field values assigned to the domain alias. This extends the parent Site's custom fields so only translated fields need to be provided
added	timestamp	Date and time domain alias was created
modified	timestamp	Date and time domain alias was modified

Example object:

{
    "added": "2013-06-19T11:17:13",
    "base_directory": "/succursale/location-name/",
    "custom_fields": {
        "headline": "Emplacement de la marque"
    },
    "deleted": false,
    "domain": "www.brandname.ca",
    "formatted_domain": "www.brandname.ca",
    "formatted_url": "https://www.brandname.ca/succursale/location-name/",
    "id": 12345,
    "language_code": "fr",
    "modified": "2014-01-28T13:20:13",
    "partner_alias_id": "fr-locationpage-55555555",
    "preview_url": "http://www.brandname.ca.whitelabel.cloudbackend.net/succursale/location-name/",
    "site_id": 55555,
    "trace_id": null,
    "user_id": 248114
}

Create a domain alias

POST /api/v2/domain_aliases/

Attribute
formatted_domain
site_id
language_code

List domain aliases

List all domain aliases including active and deleted

GET /api/v2/domain_aliases/

List all domain aliases associated with a Site ID

GET /api/v2/domain_aliases/?site_id=12345

Parameters

Name	Type	Description
language_code	string	Filter for domain aliases with a matching locale
site_id	integer	Filter for domain aliases associated with a particular Site

Response

{
  "meta": {
    "limit": 20,
    "next": "/api/v2/domain_aliases/?limit=20&offset=20",
    "offset": 0,
    "previous": null,
    "total_count": 154
  },
  "objects": [
    {
      "added": "2013-06-19T11:17:13",
      "base_directory": "/succursale/location-name/",
      "deleted": false,
      "domain": "www.brandname.ca",
      "formatted_domain": "www.brandname.ca",
      "formatted_url": "https://www.brandname.ca/succursale/location-name/",
      "id": 12345,
      "language_code": "fr",
      "modified": "2014-01-28T13:20:13",
      "partner_alias_id": "fr-locationpage-55555555",
      "preview_url": "http://www.brandname.ca.whitelabel.cloudbackend.net/succursale/location-name/",
      "site_id": 55555,
      "trace_id": null,
      "user_id": 248114
    },
    ....
  ]
}

Get a single domain alias

Fetch the Domain alias detail using the DomainAlias.id

GET /api/v2/domain_aliases/:id/

Updating a domain alias

PUT /api/v2/domain_aliases/:id/

You can PUT a partial or full object to the detail endpoint to update/change values on the Domain alias object. If using a partial object, you must insure that the primary domain alias id is part of the payload.

Disabling / enabling a domain alias

Disabling a domain alias

To disable an active domain alias and clear all cache references to the domain, use the DELETE method on the Domain alias detail endpoint.

DELETE /api/v2/domain_aliases/:id/

Enabling a domain alias

To enable a currently disabled domain alias, you will set the param for deleted to False using the Update endpoint