EdgeNext Documentation

Endpoint

Request URL: domain/config (GET)

API Host: cdn.api.edgenext.com

API Version: v2

Description

Queries domain configuration, including cache rules, origin server, IP blacklist, and referer blacklist/whitelist settings.

Notes:

• Rate limit: 30 requests per minute.
• This API queries configuration for non-live-streaming acceleration domains only.
• Please contact your project manager to request access.

Request Parameters

The following list only includes API-specific request parameters. Common request parameters must also be included for production calls. Common parameters: Tokens can be obtained from the on-call team.

GET Parameters

Parameters are appended to the URL query string, e.g. ?key1=value1&key2=value2.

Parameter	Data Type	Required	Description
domains	string	Yes	Domain name(s). Multiple domains separated by commas (,). Maximum 10 domains per request.
config	array	Yes	Configuration items to query. Returns all configurations if empty. Example: ["referer","origin","ip_black_list","cache_rule"]``referer: Referer blacklist/whitelistorigin: Origin server configurationip_black_list: IP blacklistcache_rule: Cache rulesorigin_host: Origin host header

Example

curl -X GET 'https://cdn.api.edgenext.com/v2/domain/config?token=token&domains=www.test.com&config[]=referer&config[]=origin' -g

Response Example

JSON format:

{
    "code": 0,   // 0 = success; returns configuration query results
    "data": [
    {
        "domain": "www.test.com",   // Domain name
        "domain_id": "25419",       // Domain ID
        "config": {
            "referer": {        // Referer blacklist/whitelist configuration
                "allow_empty": true, // true: allow empty referer; false: block empty referer
                "type": 1,        // Rule type: 1 = whitelist, 2 = blacklist
                "list": [          // Referer list
                    "*.aaa.test.com",
                    "www.test.com"
                ]
            },
            "origin": {
                "default_master": "xj-mbs-yabo-origin-a937umzq6s5.prdasbbwla2.com",
                "default_slave": "1.1.1.1",
                "origin_mode": "custom",
                "ori_https": "yes",
                "port": "444",
                "dx_master": "1.1.1.1",
                "lt_master": "1.1.1.2"
            }
        }
    },
        ...
    ]
}

Response Headers

HTTP/1.0 200 OK
Api-Id:                814
Content-Type:          application/json; charset=utf-8
X-Ratelimit-Grad:      minute  // Rate limit granularity (minute/hour/day)
X-Ratelimit-Limit:     30  // Requests per minute limit
X-Ratelimit-Remaining: 29   // Remaining requests this minute
X-Retry-After:         58  // Seconds until the current rate limit window resets

HTTP Status Codes

Status Code	Description
404	The requested URL is invalid
401	Authentication error — invalid token or API access not enabled
400	Invalid request parameters
200	Request succeeded, data returned
5xx	Please contact the on-call team