Retrieves a list of customer origin configurations associated with the CAN platform.
A request to retrieve a list of customer origins is described below.
HTTP Method | Request URI |
---|---|
GET |
https://api.transactcdn.com/v2/mcc/customers/AccountNumber/origins/adn |
Define the following variable when submitting the above request.
VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3). | Description |
---|---|
Required |
|
This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.
Request body parameters are not required by this endpoint.
The response to the above request includes an HTTP status code, response headers, and a response body.
A status code indicates whether the request was successfully performed.
The response for this endpoint only includes standard HTTP response headers.
The response body for a successful request contains the following response parameters for each customer origin configuration returned by this endpoint:
Name | Data Type | Description |
---|---|---|
FollowRedirects |
Boolean |
Indicates whether our edge servers will respect a URL redirect when validating the set of optimal CAN gateway servers for your customer origin configuration. |
NetworkConfiguration |
Integer |
Indicates how hostnames associated with a customer origin configuration will be resolved to an IP address.
|
ValidationURL |
String |
Indicates the URL to a sample asset. A set of optimal CAN gateway servers for your customer origin server is determined through the delivery of this sample asset. |
DirectoryName |
String |
Identifies the directory name assigned to the customer origin configuration. This alphanumeric name is appended to the end of the base CDN URL that points to the customer origin server Example: http://can.0001.transactcdn.com/800001/CustomerOriginThis variable represents the directory name assigned to your customer origin configuration. |
HostHeader |
String |
Identifies the value that will be assigned to the Host header for all requests to this customer origin configuration. |
HttpFullUrl |
String |
Indicates the CDN URL for HTTP requests to this customer origin server. |
HttpHostnames |
Array |
This response parameter contains the hostnames that will handle HTTP requests. |
IsPrimary |
Integer |
HttpHostnames array Indicates whether a particular hostname/IP address is the primary one for HTTP requests. Valid values are:
|
Name |
String |
HttpHostnames array Reports the URL for the current hostname/IP address. This URL consists of the protocol, hostname/IP address, and the port. |
Ordinal |
Integer |
HttpHostnames array Indicates the position in the ordered list for the current hostname/IP address. This position is primarily used by "Primary and Failover" load balancing mode to determine which hostname/IP address will take over when a hostname/IP address higher on the list is unreachable. |
HttpLoadBalancing |
String |
Indicates how HTTP requests will be load balanced for the specified hostnames/IP addresses. Valid values are:
The load balancing mode indicated for your customer origin configuration is independent from any load balancing configuration that may exist at the origin server. |
HttpsFullUrl |
String |
Indicates the CDN URL for HTTPS requests to this customer origin server. |
HttpsHostnames |
Array |
This response parameter contains the hostnames/IP addresses that will handle HTTPS requests. |
IsPrimary |
Integer |
HttpsHostnames array Indicates whether a particular hostname/IP address is the primary one for HTTPS requests. Valid values are:
|
Name |
String |
HttpsHostnames array Reports the URL for the current hostname/IP address. This URL consists of the protocol, hostname/IP address, and the port. |
Ordinal |
Integer |
HttpsHostnames array Indicates the position in the ordered list for the current hostname/IP address. This position is primarily used by "Primary and Failover" load balancing mode to determine which hostname/IP address will take over when a hostname/IP address higher on the list is unreachable. |
HttpsLoadBalancing |
String |
Indicates how HTTPS requests will be load balanced for the specified hostnames/IP addresses. Valid values are:
The load balancing mode indicated for your customer origin configuration is independent from any load balancing configuration that may exist at the origin server. |
Id |
Integer |
Indicates the unique ID assigned to this customer origin configuration. |
MediaTypeId |
Integer |
Identifies the platform on which the customer origin configuration resides. This response parameter will always report "14," which is the value assigned to the CAN platform. |
The response body for an unsuccessful request may contain an error parameter that provides additional information.
A sample JSON request is shown below.
GET https://api.transactcdn.com/v2/mcc/customers/0001/origins/adn HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/json
Host:api.transactcdn.com
A sample JSON response is shown below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/json; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 1100
[{ "FollowRedirects" : true, "NetworkConfiguration" : 1, "ValidationURL" : "http:\/\/socialmedia.example.com\/images\/PerformanceTestObject_5k.gif", "DirectoryName" : "socialmedia", "HostHeader" : "socialmedia.example.com", "HttpFullUrl" : "http:\/\/can.0001.transactcdn.com\/800001\/socialmedia", "HttpHostnames" : [{ "IsPrimary" : 1, "Name" : "http:\/\/socialmedia.example.com:80", "Ordinal" : 0 } ], "HttpLoadBalancing" : "PF", "HttpsFullUrl" : "", "HttpsHostnames" : [], "HttpsLoadBalancing" : "", "Id" : 44764, "MediaTypeId" : 14 }, { "FollowRedirects" : true, "NetworkConfiguration" : 1, "ValidationURL" : "http:\/\/banking.example.com\/asset.txt", "DirectoryName" : "banking", "HostHeader" : "banking.example.com", "HttpFullUrl" : "http:\/\/can.0001.transactcdn.com\/800001\/banking", "HttpHostnames" : [{ "IsPrimary" : 1, "Name" : "http:\/\/banking.example.com:80", "Ordinal" : 0 } ], "HttpLoadBalancing" : "PF", "HttpsFullUrl" : "", "HttpsHostnames" : [], "HttpsLoadBalancing" : "", "Id" : 114197, "MediaTypeId" : 14 } ]
A sample XML request is shown below.
GET https://api.transactcdn.com/v2/mcc/customers/0001/origins/adn HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/xml
Host:api.transactcdn.com
A sample XML response is shown below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/xml; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 1561
<ArrayOfCustomerOrigin xmlns="http://www.whitecdn.com/schemas/apiservices/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <CustomerOrigin> <FollowRedirects>true</FollowRedirects> <NetworkConfiguration>1</NetworkConfiguration> <ValidationURL>http://socialmedia.example.com/images/PerformanceTestObject_5k.gif</ValidationURL> <DirectoryName>socialmedia</DirectoryName> <HostHeader>socialmedia.example.com</HostHeader> <HttpFullUrl>http://can.0001.transactcdn.com/800001/socialmedia</HttpFullUrl> <HttpHostnames> <Hostname> <IsPrimary>1</IsPrimary> <Name>http://socialmedia.example.com:80</Name> <Ordinal>0</Ordinal> </Hostname> </HttpHostnames> <HttpLoadBalancing>PF</HttpLoadBalancing> <HttpsFullUrl/> <HttpsHostnames/> <HttpsLoadBalancing/> <Id>44764</Id> <MediaTypeId>14</MediaTypeId> </CustomerOrigin> <CustomerOrigin> <FollowRedirects>true</FollowRedirects> <NetworkConfiguration>1</NetworkConfiguration> <ValidationURL>http://banking.example.com/asset.txt</ValidationURL> <DirectoryName>banking</DirectoryName> <HostHeader>banking.example.com</HostHeader> <HttpFullUrl>http://can.0001.transactcdn.com/800001/banking</HttpFullUrl> <HttpHostnames> <Hostname> <IsPrimary>1</IsPrimary> <Name>http://banking.example.com:80</Name> <Ordinal>0</Ordinal> </Hostname> </HttpHostnames> <HttpLoadBalancing>PF</HttpLoadBalancing> <HttpsFullUrl/> <HttpsHostnames/> <HttpsLoadBalancing/> <Id>114197</Id> <MediaTypeId>14</MediaTypeId> </CustomerOrigin> </ArrayOfCustomerOrigin>