The Proxies resource is the primary way of publishing and managing reverse proxy sites within the platform
A proxy object contains the following fields
Attribute | Type | Description |
id | integer | unique id of the proxy |
business_id | integer | Reference id to the Business this proxy is under |
user_id | integer | Reference id to the User that created this proxy |
domain | string | The hostname/domain where the proxy is published |
source_domain | string | The URL without including the path of the site you want to proxy |
deleted | boolean | Field that denotes if the proxy is disabled or not |
https | boolean | Toggle for enabling SSL for the proxy |
extra_css | string | Extra CSS to add to all the proxy's pages |
footer_code | string | Extra HTML to add to all the proxy's pages right before the ending |
header_code | string | Extra HTML to add to all the proxy's pages right before the ending |
added | timestamp | Date and time proxy was created |
modified | timestamp | Date and time proxy was modified |
ssl_last_updated | string | Timestamp of when the proxy's SSL was last updated |
custom_fields | object | Custom field values assigned to the site |
{"added": "2016-12-07T19:20:26","aliases": [],"autolink": false,"business": {... fully expanded `Business` object},"business_id": 12345,"cache_html": false,"country": "US","custom_fields": {"campaign_id": "GA12345"},"deleted": false,"disable_analytics_events": ["form-submit"],"domain": "www.yourproxydomain.com","extra_css": ".body { background-color: red }","filter_querystring": true,"footer_code": "<script>...</script>","formatted_url": "http://www.yourproxydomain.com/","gtm_id": 'ABG456',"header_code": "<meta .../>","https": false,"id": 54321,"ignored_numbers": [],"image_replacements": [{"image_id": 654321,"image_path": "/assets/some-image.jpg"}],"include_jquery": "1.11.0","modified": "2017-03-20T13:42:10","number_replacements": [{"new_number": "206-777-7777","number": "206-555-5555"},{"new_number": "206-999-9999","number": "206-666-6666"}],"partner_proxy_category_id": null,"partner_proxy_id": null,"partner_proxy_sub_id": null,"phone": null,"preview_url": "http://www.yourproxydomain.com.yourwhitelabel.cloudbackend.net/","replace_patterns": [{"string_to_replace": "Shop today","replacement_string": "Shop tomorrow"}],"resource_uri": "/api/v2/proxies/54321/","source_domain": "http://www.customerdomain.com","ssl_last_updated": null,"user_id": 1234}
List all proxies including active, deleted, non-published and published
GET /api/v2/proxies/
List all active proxies
GET /api/v2/proxies/?deleted=0
Name | Type | Description |
|
| Filter for proxies associated with a particular |
|
| Return proxies based on if they are active ( |
|
| Searching by domain/subdomain similar to how you pass formatted_domain on Proxy creation |
|
| Used to lookup/search for proxies matching a particular internal id |
{"meta":{"limit":20,"next":null,"offset":0,"previous":null,"total_count":1},"objects":[{"added": "2016-07-26T19:39:18","autolink": false,"base_directory": "/","business_id": 24305,"country": "US","deleted": false,"domain": "someproxy.cloudbackend.net","extra_css": null,"footer_code": null,"header_code": null,"https": false,"id": 12345,"modified": "2016-07-26T19:39:18","partner_proxy_id": null,"phone": "(206) 555-5555","replace_patterns": [],"resource_uri": "/api/v2/proxies/12345/","source_domain": "http://www.example.com","theme_settings": {},"user_id": 123},{"added": "2016-07-26T19:39:18","autolink": false,"base_directory": "/","business_id": 24305,"country": "US","deleted": false,"domain": "anotherproxy.cloudbackend.net","extra_css": null,"footer_code": null,"header_code": null,"https": false,"id": 12346,"modified": "2016-07-26T19:39:18","partner_proxy_id": null,"phone": "(206) 555-5555","replace_patterns": [],"resource_uri": "/api/v2/proxies/12346/","source_domain": "http://www.example.com","theme_settings": {},"user_id": 123},...]}
Fetch the Proxy detail using the Proxy.id
GET /api/v2/proxies/:id/
{"added": "2016-07-26T19:39:18","autolink": false,"base_directory": "/","business": {... fully expanded `Business` object},"business_id": 24305,"country": "US","deleted": false,"disable_cache": false,"domain": "someproxy.cloudbackend.net","extra_css": null,"footer_code": null,"header_code": null,"https": false,"id": 12345,"modified": "2016-07-26T19:39:18","partner_proxy_id": null,"phone": "(206) 555-5555","replace_patterns": [],"resource_uri": "/api/v2/proxies/12345/","source_domain": "http://www.example.com","theme_settings": {},"user_id": 123}
POST /api/v2/proxies/
Name | Type | Description |
|
| required |
|
| required Full URL of the source site (i.e. http://www.example.com). Supports |
|
| required If you know the user account you want to publish this proxy on the behalf of, use |
​ | ​ | ​ |
Optional | ​ | ​ |
|
| Under private labels with sub-directory based proxies, this is where it is defined (defaults to slash |
{"domain": "someproxy.cloudbackend.net","source_domain": "http://www.example.com","user_id": 1}
A status code of 201 created
is returned on a successful creation and contains the created proxy object as JSON. See the Get a single proxy section for an example Proxy object.
PUT /api/v2/proxies/:id/
You can PUT
a partial or full object to the detail endpoint to update/change values on the Proxy object. If using a partial object, you must insure that the primary proxy id
is part of the payload.
To disable an active proxy and clear all cache references to the domain, use the DELETE
method on the Proxy detail endpoint.
DELETE /api/v2/proxies/:id/
To enable a currently disabled proxy, you will set the param for deleted
to False
using the Proxy update endpoint.