API docs by Redocly

5centsCDN - SimpleDNS (1.0.0)

Download OpenAPI specification:Download

API for managing SimpleDNS

Contact Support:
Email: [email protected]

default

List Zones

Authorizations:
apikeyAuth
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "result": "success",
  • "domains": [
    ]
}

Create Zones

Authorizations:
apikeyAuth
header Parameters
Accept
string
Example: application/json
Request Body schema: application/x-www-form-urlencoded
domain
string

New DNS Domain
_METHOD
string

masking post -> put request

Responses

Response samples

Content type
application/json
Example
{
  • "status": {
    },
  • "statusDescription": {
    }
}

Get UpdatedStatus

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
text/plain
true

Enable/Disable Zone

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
status
integer

1: Enable, 0: Disable

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The zone was activated!"
}

Delete Zone

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
_METHOD
string

casting post -> delete

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "Domain zone vivek.com was disabled. Will be fully removed after usage billing."
}

Restore Zone

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "Zone Restored"
}

Get Zone Statistics

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone Statistics (Last 30 Days)

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone Statistics (Monthly)

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone Statistics (Yearly)

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone Statistics (Daily)

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone Statistics (Hourly)

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "options": {
    },
  • "message": null
}

Get Zone DNSSEC

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Activate Zone DNSSEC

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
status
integer

1: activate, 0: deactivate

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The DNSSEC is activated for your zone. The keys will be generated soon."
}

Get Zone SOA

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Update Zone SOA

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: application/json
primaryNS
string
  • Specifies the primary nameserver for the zone.
    • This is the main DNS server that holds authoritative information about the domain.
    • Example values include:
      • pns31.5centscdn.com
      • dns1.example.com
adminMail
string
refresh
string
  • The refresh interval for the secondary DNS server to check for updates from the primary server.
    • Measured in seconds and determines how frequently secondary servers will update their records.
    • Example values include:
      • 3600 (1 hour)
      • 7200 (2 hours)
retry
string
  • The retry interval for secondary DNS servers if a refresh fails.
    • Specifies how long the secondary server should wait before retrying to contact the primary server.
    • Example values include:
      • 1800 (30 minutes)
      • 3600 (1 hour)
expire
string
  • The expiration time for data held by secondary servers if they cannot contact the primary server.
    • After this time, the secondary server discards the zone data as it is considered outdated.
    • Example values include:
      • 1209600 (2 weeks)
      • 604800 (1 week)
defaultTTL
string
  • The default time-to-live (TTL) value for DNS records in the zone.
    • Specifies how long DNS records are cached by resolvers before they must query again.
    • Example values include:
      • 3600 (1 hour)
      • 86400 (1 day)

Responses

Request samples

Content type
application/json
{
  • "primaryNS": "pns31.5centscdn.com",
  • "adminMail": "[email protected]",
  • "refresh": "3600",
  • "retry": "1800",
  • "expire": "1209600",
  • "defaultTTL": "3600"
}

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The SOA record was modified successfully."
}

Export Zone

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
text/plain
$ORIGIN 5centscdn.dev.
@	3600	IN	SOA	pns31.5centscdn.com. support.5centscdn.com. 2022042311 3600 1800 1209600 3600
@	3600	IN	NS	pns31.5centscdn.com.
@	3600	IN	NS	pns32.5centscdn.com.
@	3600	IN	NS	pns33.5centscdn.com.
@	3600	IN	NS	pns34.5centscdn.com.
ww3	60	IN	A	51.222.141.228
www	60	IN	A	51.222.141.228
cdn	3600	IN	CNAME	pull-2871.5centscdn.com.
_acme-challenge.ww3	3600	IN	TXT	"fC95Tjct5eB1a4qUe7UpPSt4un6ivngEvJrKABKtm24"
test	60	IN	A	2.2.2.2
;@	60	IN	ALIAS	pull-2871.5centscdn.com
@	60	IN	A	23.217.99.152
@	60	IN	A	23.217.99.162
@	60	IN	AAAA	2a02:26f0:d7::17d9:63c0
@	60	IN	AAAA	2a02:26f0:d7::17d9:63cb
vikesh	60	IN	A	7.8.9.1
testt	60	IN	A	8.8.8.8
test2	60	IN	A	8.8.8.8
258288550proxy	60	IN	CNAME	www.google.com.
proxy	300	IN	CNAME	pull-3061.5centscdn.com.

Import Zone

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
format
string

bind/tinydns
file
string <binary>
delete-existing-records
integer

0: No, 1: Yes
record-types[]
string

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The records of 5centscdn.dev were added successfully."
}

Get Mail Forwards

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{}

Delete Mail Forward

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
mail-forward-id
string

mail forward id
_METHOD
string

post -> delete

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The mail forward has been deleted successfully."
}

Get Records

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
query Parameters
limit
integer
Example: limit=10
page
integer
Example: page=1
host
string
type
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "domain": {
    },
  • "pageMax": 3,
  • "records": {
    }
}

Add Record

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
_METHOD
string

post -> put
type
string

A, AAAA, MX, CNAME, TXT, NS, SRV, WR, RP, SSHFP, ALIAS, CAA, TLSA, CERT, DS for domain names, NS and PTR for reversed zones, and NAPTR, NS, CNAME for ENUM zones
ttl
integer

Available TTL's: 60 = 1 minute 300 = 5 minutes 900 = 15 minutes 1800 = 30 minutes 3600 = 1 hour 21600 = 6 hours 43200 = 12 hours 86400 = 1 day 172800 = 2 days 259200 = 3 days 604800 = 1 week 1209600 = 2 weeks 2592000 = 1 month
host
string

host / subdomain
record
string

Record you want to add. Example 10.10.10.10 or cname.5centscdn.com
priority
string

Priority for MX or SRV record
weight
string

Weight for SRV record
port
string

Port for SRV record
frame
string

0 or 1 for Web redirects to disable or enable frame
frame-title
string

Title if frame is enabled in Web redirects
frame-keywords
string

Keywords if frame is enabled in Web redirects
frame-description
string

Description if frame is enabled in Web redirects
mobile-meta
string

Mobile responsive meta tags if Web redirects with frame is enabled. Default value - 0.

save-path
string

0 or 1 for Web redirects
redirect-type
string

301 or 302 for Web redirects if frame is disabled
mail
string

E-mail address for RP records
txt
string

Domain name for TXT record used in RP records
algorithm
string

The algorithm of the referenced DS record.
fptype
string

Type of the SSHFP algorithm. Required for SSHFP records only.
status
string

Set to 1 to create the record active or to 0 to create it inactive. If omitted the record will be created active.
caa_flag
string

0 - Non critical or 128 - Critical
caa_type
string

Type of CAA record. The available flags are issue, issuewild, iodef.
caa_value
string

If caa_type is issue, caa_value can be hostname or ";". If caa_type is issuewild, it can be hostname or ";". If caa_type is iodef, it can be "mailto:someemail@address.tld, http://example.tld or http://example.tld.
tlsa_usage
string

(From 0 to 3) It shows the provided association that will be used.
tlsa_selector
string

(From 0 to 1) It specifies which part of the TLS certificate presented by the server will be matched against the association data
tlsa_matching_type
string

(From 0 to 2) It specifies how the certificate association is presented.
key-tag
string

A numeric value used for identifying the referenced DS record.
digest-type
string

The cryptographic hash algorithm is used to create the Digest value.
order
string

Specifies the order in which multiple NAPTR records must be processed (low to high).
pref
string

Specifies the order (low to high) in which NAPTR records with equal Order values should be processed.
flag
string

Controls aspects of the rewriting and interpretation of the fields in the record.
params
string

Specifies the service parameters applicable to this delegation path.
regexp
string

Contains a substitution expression that is applied to the original string, held by the client in order to construct the next domain name to lookup.
replace
string

Specifies the next domain name (fully qualified) to query for depending on the potential values found in the flags field.
cert-type
string

Type of the Certificate/CRL
cert-key-tag
string

A numeric value (0-65535), used the efficiently pick a CERT record.
cert-algorithm
string

Identifies the algorithm, used to produce a legitimate signature.

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The record was added successfully.",
  • "data": {
    }
}

Delete Record

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
recordid
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
_METHOD
string

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The record was deleted successfully."
}

Enable/Disable Record

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
recordid
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
status
integer

1: Enable, 0: Disable

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "Record deactivated"
}

Proxy Record

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
recordid
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
mode
string

1: Enable, 0: Disable
optimize
string
ssl
string
cache
string
expiry
string
cachecontrol
string
usestale
string
revalidate
string
scheme
string
port
integer
status
integer
type
string
host
string
record
string
ttl
integer

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "CDN Proxy enabled. <a href='/dashboard/103/zones/http/pull/3062' target='_blank'>Pull Zone #3062</a>"
}

Get/Activate Record DynamicURL

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
recordid
required
string
header Parameters
Accept
string
Example: application/json

Responses

Response samples

Content type
application/json
Example
{
  • "status": {
    },
  • "statusDescription": {
    }
}

Delete/Disable Record DynamicURL

Authorizations:
apikeyAuth
path Parameters
dnsId
required
string
recordid
required
string
header Parameters
Accept
string
Example: application/json
Request Body schema: multipart/form-data
_METHOD
string

Responses

Response samples

Content type
application/json
{
  • "status": "Success",
  • "statusDescription": "The DynamicURL of ww3.5centscdn.dev was deactivated."
}