Download OpenAPI specification:Download
Domeneshop offers a simple, REST-based API, which currently supports the following features:
More features are planned, including:
The API service is in version 0, which means it is possible that the interface will change rapidly during the testing period. For that reason, the documentation on these pages may sometimes be outdated.
Additionally, we make no guarantees about the stability of the API service during this testing period, and therefore ask customers to be careful with using the service for business critical purposes.
The Domeneshop API currently supports only one method of authentication, HTTP Basic Auth. More authentication methods may be added in the future.
To generate credentials, visit this page after logging in to the control panel on our website:
Domeneshop maintains multiple API libraries to simplify using the API. Please note that these libraries have the same stability guarantees to the API while the API is in version 0.
The libraries may be found in our Github repository.
Domeneshop also maintains a plugin for EFF's Certbot, which automates issuance and renewal of SSL-certificates on your own servers for domains that use Domeneshop's DNS service. This plugin is found in our Github repository here.
domain | string Example: domain=.no Only return domains whose |
[- {
- "id": 1,
- "domain": "example.com",
- "expiry_date": "2019-08-24",
- "registered_date": "2019-08-24",
- "renew": true,
- "registrant": "Ola Nordmann",
- "status": "active",
- "nameservers": [
- "ns1.hyp.net",
- "ns2.hyp.net",
- "ns3.hyp.net"
], - "services": {
- "registrar": true,
- "dns": true,
- "email": true,
- "webhotel": "none"
}
}
]
domainId required | integer ID of the domain |
{- "id": 1,
- "domain": "example.com",
- "expiry_date": "2019-08-24",
- "registered_date": "2019-08-24",
- "renew": true,
- "registrant": "Ola Nordmann",
- "status": "active",
- "nameservers": [
- "ns1.hyp.net",
- "ns2.hyp.net",
- "ns3.hyp.net"
], - "services": {
- "registrar": true,
- "dns": true,
- "email": true,
- "webhotel": "none"
}
}
These endpoints allow you to list, create and delete DNS records for any domain that has active DNS service.
domainId required | integer ID of the domain |
host | string Example: host=www Only return records whose |
type | string Example: type=A Only return records whose |
[- {
- "id": 1,
- "host": "@",
- "ttl": 3600,
- "type": "A",
- "data": "192.168.0.1"
}
]
domainId required | integer ID of the domain |
host required | string The host/subdomain the DNS record applies to |
ttl | integer <int16> [ 60 .. 604800 ] Default: 3600 TTL of DNS record in seconds. Must be a multiple of 60. |
type required | string Value: "A" |
data required | string <ipv4> IPv4 address |
{- "host": "@",
- "ttl": 3600,
- "type": "A",
- "data": "192.168.0.1"
}
{- "id": 1
}