DNS-API

Alle endepunkter krever Bearer-token-autentisering.

For operasjoner på domenenivå (registrering, endring av registrant, DNSSEC, oppdatering av navneservere), se Domener-API.

Soner

GET /dns/zones

List alle DNS-soner på kontoen.

Hver oppføring har sone-ID, navn, type, beskyttelsesstatus, registrar, utløp og antall poster.

POST /dns/zones

Opprett en ny sone.

Felt	Type	Påkrevd	Standard	Beskrivelse
zone_name	string	Ja	ingen	Domenenavn.
zone_type	string	Nei	NATIVE	NATIVE eller MASTER. SLAVE (sekundær DNS) er ikke tilgjengelig for øyeblikket og gir 403 Secondary DNS is not available at the moment.
create_default_records	boolean	Nei	false	Opprett standardposter (A/MX osv.) automatisk.
transfer_domain	boolean	Nei	false	Overfør også domenet til Gigahost. Se Overføringer for hva hvert toppdomene krever.
auth_code	string	Ved overføring	ingen	Autorisasjonskode fra avgivende registrar, eller en engangskode fra Norid for .no. Brukes ikke for .uk.
use_existing_ns	boolean	Nei	false	Behold de eksisterende NS-postene.

curl -X POST https://api.gigahost.no/api/v0/dns/zones \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "zone_name": "example.com",
    "zone_type": "NATIVE",
    "create_default_records": true
  }'

Importer en BIND-sonefil i stedet: bruk multipart/form-data med zone_name og et zone_file-felt (maks 2 MB).

Et sonenavn som finnes fra før, gir 400 Zone already exists. Et domene som allerede overføres, gir 409 A transfer for this domain is already in progress.

DELETE /dns/zones/{zone_id}

Slett en sone. Soner for domener som er registrert hos Gigahost, er beskyttet og gir 403 This zone is protected and cannot be deleted. Please cancel the domain registration first.

Poster

Endringer i en sekundær sone som allerede finnes, gir 400 This zone is a secondary zone. Its contents are managed by your primary nameserver.

GET /dns/zones/{zone_id}/records

List alle poster i en sone.

Hver post har: id, name, type, value, ttl, priority (for MX).

POST /dns/zones/{zone_id}/records

Opprett en post.

Felt	Type	Påkrevd	Standard	Beskrivelse
record_value	string	Ja	ingen	Verdien (IP, vertsnavn, TXT-streng …).
record_name	string	Nei	@	Underdomenet eller @ for roten.
record_type	string	Nei	A	A, AAAA, CNAME, MX, TXT, NS, SRV, …
record_ttl	number	Nei	3600	TTL i sekunder.
record_priority	number	For MX	ingen	Prioritet for MX-poster.

curl -X POST https://api.gigahost.no/api/v0/dns/zones/966/records \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "record_name": "www",
    "record_type": "A",
    "record_value": "198.51.100.10",
    "record_ttl": 3600
  }'

PUT /dns/zones/{zone_id}/records/{record_id}

Samme body som POST. A-verdier må være IPv4, AAAA-verdier IPv6, og MX-poster må ha record_priority.

DELETE /dns/zones/{zone_id}/records/{record_id}

Slett en post.

Param	Hvor	Beskrivelse
record_id	URL	Post-ID.
name	Query	Postnavn (f.eks. www).
type	Query	Posttype (f.eks. A).

curl -X DELETE \
  "https://api.gigahost.no/api/v0/dns/zones/966/records/abc123?name=www&type=A" \
  -H "Authorization: Bearer $TOKEN"

Redirects

En redirect sender et underdomene eller @ til en URL, via en A-post som peker til redirect-serveren hos Gigahost.

GET /dns/zones/{zone_id}/redirect

List redirects på en sone. Ikke tilgjengelig for eksternt hostede soner.

POST /dns/zones/{zone_id}/redirect

Felt	Type	Påkrevd	Standard	Beskrivelse
target_url	string	Ja	ingen	Gyldig URL det skal redirectes til.
source	string	Nei	@	Underdomene eller @ for roten.

Mulige feil:

• Eksisterende A-poster er i konflikt
• Redirecten finnes allerede
• Eksterne navneservere er konfigurert
• Ugyldig URL-format

PUT /dns/zones/{zone_id}/redirect

Oppdater mål-URLen.

Felt	Type	Beskrivelse
source	string	Underdomene eller @.
target_url	string	Ny mål-URL.

DELETE /dns/zones/{zone_id}/redirect

Slett en redirect (og A-postene bak den).

curl -X DELETE \
  "https://api.gigahost.no/api/v0/dns/zones/966/redirect?source=@" \
  -H "Authorization: Bearer $TOKEN"

Reverse DNS (PTR)-soner

For gjennomgangen i panelet, se Sett opp reverse DNS (PTR) på rutet /48 IPv6.

POST /dns/zones/ptr

Opprett en PTR-sone.

IPv4:

Felt	Type	Beskrivelse
prefix	string	f.eks. 198.51.100.
ip_version	string	ipv4.
zone_name	string	f.eks. 100.51.198.in-addr.arpa.

IPv6 (rutet /48):

Felt	Type	Beskrivelse
prefix	string	f.eks. 2001:db8::.
ip_version	string	ipv6.
zone_name	string	f.eks. 0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa.

Når PTR-sonen er opprettet, legger du til poster i den med de vanlige post-endepunktene og delegerer prefikset til de nye navneserverne via PUT /servers/{id}/reverse.

Oppslag

GET /dns/domains/check/{domain}

Sjekk om et domene er ledig, for alle toppdomenene Gigahost tilbyr. Krever ikke autentisering.

curl https://api.gigahost.no/api/v0/dns/domains/check/example.no

data inneholder domain, available og reason, pluss pricing (registration_price, renewal_price, currency, min_year og premium, som er true for premiumnavn). Et toppdomene som ikke tilbys, gir 400 This TLD is not available for registration. Hver IP-adresse kan gjøre 5000 oppslag per døgn; deretter returnerer kallet 429 Too many domain lookups. Please try again later.

GET /dns/pricing

Toppdomenene som tilbys, med tld, registration_price, renewal_price, currency, registrar og min_year (korteste registreringsperiode i år). Krever ikke autentisering.

GET /dns/lookup/organization/{org_number}

Oppslag av norsk organisasjon via Brønnøysundregistrene.

Param	Type	Beskrivelse
org_number	string	9-sifret organisasjonsnummer.

Returnerer firmanavn, adresse, postnummer og poststed.