Domener-API

Registrer, overfør og administrer domener. DNS-poster finner du i DNS-API-et, og toppdomenene som tilbys og prisene deres i GET /dns/pricing.

Alle endepunkter krever Bearer-token-autentisering.

Registrering

POST /dns/domains/register

Registrer et nytt domene. Feltene avhenger av toppdomenet: .no under, andre toppdomener etter det. En konto som er til gjennomgang, får 400 Your account is currently under review and domain orders are temporarily disabled.

.no-domener

Felles felter:

Felt	Type	Påkrevd	Standard	Beskrivelse
domain_name	string	Ja	ingen	Hele domenet (example.no).
email	string	Ja	ingen	E-postadressen til registranten.
registrant_type	string	Ja	ingen	organization eller person.
use_gigahost_ns	boolean	Nei	true	Hvis false, må du oppgi din egen NS-liste.
nameservers	array	Hvis use_gigahost_ns er false	ingen	Minst 2 vertsnavn.

Organisasjonsspesifikt:

Felt	Type	Beskrivelse
applicant_name	string	Maks 255 tegn.
org_number	string	9-sifret norsk organisasjonsnummer.
company_name	string	Maks 255 tegn.
zip_code	string
city	string

Personspesifikt:

Felt	Type	Beskrivelse
pid	string	Norsk personidentifikator på formatet N.PRI.12345678.
first_name	string
last_name	string

curl -X POST https://api.gigahost.no/api/v0/dns/domains/register \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "example.no",
    "registrant_type": "organization",
    "email": "[email protected]",
    "applicant_name": "Acme AS",
    "org_number": "999999999",
    "company_name": "Acme AS",
    "zip_code": "0000",
    "city": "Oslo"
  }'

Respons: meta.message Domain registered successfully! You will receive a confirmation email shortly. og data med zone_id, domain_name, expires_at og status.

Andre toppdomener

Felt	Type	Påkrevd	Beskrivelse
domain_name	string	Ja	Hele domenet (example.com).
registrant	object	Ja	Innehaveren av domenet (under).
admin_contact, tech_contact, billing_contact	object	Nei	Samme form som registrant. Hver som utelates, bruker registranten.
whois_privacy	boolean	Nei	Skjul innehaverens opplysninger i WHOIS. Ikke tillatt for .fi og .uk.
use_gigahost_ns	boolean	Nei	Standard true. Hvis false, send nameservers.
nameservers	array	Hvis use_gigahost_ns er false	Minst 2 vertsnavn.

Felter i registrant: first_name, last_name, address1, city, postal_code, country_code (2 bokstaver), email og phone (format +47.12345678) er påkrevd. org_name er organisasjonen, hvis det er en. registrant_number er identifikasjonsnummeret noen toppdomener krever.

curl -X POST https://api.gigahost.no/api/v0/dns/domains/register \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "example.com",
    "registrant": {
      "first_name": "Ola",
      "last_name": "Nordmann",
      "org_name": "Acme AS",
      "address1": "1 Example Street",
      "city": "Oslo",
      "postal_code": "0000",
      "country_code": "NO",
      "email": "[email protected]",
      "phone": "+47.12345678"
    },
    "whois_privacy": true
  }'

Regler per toppdomene. Brudd gir 400 med en melding som sier hvilken regel det gjelder:

Toppdomene	Regel
.es	registrant_number på 5 til 20 tegn: pass, førerkort, nasjonal ID eller organisasjonsnummer.
.it	registrant_number: mva.- eller organisasjonsnummer for firma, personnummer for privatpersoner.
.dk	registrant_number (CVR- eller organisasjonsnummer) når org_name er satt.
.se, .nu	registrant_number for alle innehavere: organisasjonsnummer, eller personnummer eller passnummer.
.fi	registrant_number i formatet som passer innehaveren: A valid Finnish business ID (Y-tunnus, e.g. 1234567-8) is required…, et finsk personnummer, et organisasjonsnummer, eller fødselsdato (YYYY-MM-DD) for privatpersoner utenfor Finland. Den tekniske kontakten må være en organisasjon: The technical contact for .fi domains must be an organization (org_name is required). Ingen WHOIS-beskyttelse.
.fr, .re, .pm, .yt, .tf, .wf	Innehaver og administrativ kontakt må bo i EU/EØS eller Sveits: .fr domains can only be registered to a person or organization resident in the EU/EEA or Switzerland.
.be	A VAT number is required when a .be domain is registered to an organization in the EU/EEA.
.nl	Domain names with special characters (IDN) are not available under .nl. Innehaveren må godkjenne registreringen fra en e-post innen 7 dager, ellers kanselleres den.
.uk	Ingen WHOIS-beskyttelse.

Respons: meta.message Domain registered successfully. og data med zone_id, domain_name, order_id, expires_at og status.

Overføringer

En overføring til Gigahost starter fra POST /dns/zones med transfer_domain: true, som oppretter sonen og starter overføringen i ett kall. For en sone som allerede finnes på kontoen din og ikke er registrert hos oss, bruker du POST /dns/domains/transfer med zone_name og auth_code.

• .no: send autorisasjonskoden fra den nåværende registraren, eller en engangskode som Norid sender til innehaveren av domenet på e-post (se under).
• .uk: ingen autorisasjonskode. Responsen er 201 med ips_tag i meta; be den nåværende registraren endre IPS-taggen til domenet til den verdien for å fullføre overføringen.
• .fr og de andre AFNIC-toppdomenene: autorisasjonskoden må ha minst 12 tegn med en stor bokstav, en liten bokstav og et siffer.
• Andre toppdomener: send auth_code og et registrant-objekt som ved registrering (minst first_name, last_name og email), pluss de samme feltene per toppdomene.

Uten auth_code (unntatt for .uk) feiler forespørselen med 400 Auth code must be provided. Et domene som allerede overføres, av deg eller i en masseoverføring, gir 409 A transfer for this domain is already in progress. En konto som er til gjennomgang, får 400 Your account is currently under review and domain transfers are temporarily disabled.

POST /dns/domains/request-token

Be Norid sende en engangskode på e-post til adressen som er registrert på et .no-domene. Bruk koden som auth_code. Sonen trenger ikke å finnes ennå.

Felt	Type	Beskrivelse
zone_name	string	.no-domenet.

Status	meta.message
200	A one-time token has been sent to the email address registered on the domain.
200	A one-time token has already been requested for this domain. (med already_requested: true)
400	A one-time token can only be requested for .no domains.
409	A transfer for this domain is already in progress.
429	Too many one-time token requests. Please try again tomorrow. (daglige grenser per konto og per domene)

Masseoverføring av .no-domener

Flytt opptil 200 .no-domener i én forespørsel, fra en liste eller rett fra en konto hos Domeneshop. Domenene overføres ett og ett i bakgrunnen, og du får resultatet på e-post når hele omgangen er ferdig. Panelsiden er beskrevet i Masseoverføring.

Endringer krever lese- og skrivetilgang til DNS for hele kontoen; en API-nøkkel som er begrenset til utvalgte soner, kan bare liste. I tillegg til meldingen om gjennomgang over kan endepunktene gi 400 DNS services are not available to this account. eller Incomplete account profile. Please complete your profile to enable DNS services.

GET /dns/domains/masstransfer

Alle åpne overføringer pluss dem som ble ferdige de siste 7 dagene. Hver oppføring har item_id, batch_id, zone_id, zone_name, display_name, status, message, source (manual eller domeneshop), switch_ns, token_requested, created, updated og expires_at.

status	Betydning
awaiting_code	Venter på engangskoden. expires_at er 48 timer etter created.
queued, processing	Venter på eller er under overføring.
done	Overført.
registry_pending	Godtatt av Norid og venter på godkjenning; Gigahost fullfører den.
failed, expired, aborted	Ikke overført; message sier hvorfor.

POST /dns/domains/masstransfer

Felt	Type	Beskrivelse
items	array	Opptil 200 oppføringer: zone_name, auth_code (maks 255 tegn), request_token (true for å la Norid sende en engangskode i stedet) og switch_ns.
switch_ns	boolean	Standard for oppføringer uten egen switch_ns: true flytter domenet til Gigahost sine navneservere etter overføringen, false beholder navneserverne det har.

Returnerer meta.message N domains queued for transfer, M waiting for a one-time code. og data med batch_id, accepted, awaiting og rejected (zone_name og reason). Oppføringer avvises enkeltvis, for eksempel med Only .no domains are supported for now., The domain is already registered with us., The domain is in use by another account. eller A transfer for this domain is already in progress.

Domenene i awaiting trenger koden sin sendt med PUT innen 48 timer.

POST /dns/domains/masstransfer/domeneshop

Les domenene, DNS-postene og videresendingene på en konto hos Domeneshop. Send api_token og api_secret fra Domeneshop, eller username og password. Ingenting fra innloggingen lagres.

data inneholder import_id og domains, hver med zone_name, display_name, supported, available, reason, on_domeneshop_ns, record_count, skipped_records, redirect_count, framed_count og expiry_date.

Status	meta.message
400	Domeneshop asks for a two-factor code. Use an API key instead. (med otp_required: true)
400	Could not log in to Domeneshop. Check the username and password.
400	Could not read the domain list from Domeneshop. Check the API key.
502	Domeneshop could not be reached. Please try again later.

POST /dns/domains/masstransfer/import

Felt	Type	Beskrivelse
import_id	number	Fra lesingen hos Domeneshop. Gjelder i 1 time.
zone_names	array	Domenene som skal flyttes, opptil 200.

Oppretter sonene, kopierer DNS-postene og videresendingene for domener på Domeneshop sine navneservere, og lar Norid sende en engangskode på e-post til innehaveren av hvert domene. Domener på Domeneshop sine navneservere flyttes til Gigahost sine navneservere etter overføringen; domener på andre navneservere beholder dem. Returnerer data med batch_id, accepted, rejected og redirects_created. En utløpt import gir 404 The import has expired. Please connect to Domeneshop again.

PUT /dns/domains/masstransfer

Send inn engangskodene.

Felt	Type	Beskrivelse
codes	array	Oppføringer med item_id og auth_code.

Returnerer meta.message N domains queued for transfer. og data.queued. Venter ingen av oppføringene på kode: 400 No codes were saved. The domains may no longer be waiting for a code.

POST /dns/domains/masstransfer/{item_id}/token

Send engangskoden på nytt. Returnerer 200 A one-time code has been sent to the email address registered on the domain., eller 429 Too many one-time code requests for this domain today. Please try again tomorrow.

DELETE /dns/domains/masstransfer/{item_id}

Avbryt en overføring som fortsatt venter på kode eller står i kø. Returnerer 200 The transfer was aborted., eller 400 This transfer is already being processed and can no longer be aborted.

Registrant

GET /dns/zones/{zone_id}/registrant

Hent kontaktinformasjon om registranten fra Norid. Kun registrerte .no-domener.

PUT /dns/zones/{zone_id}/registrant

Bytt registrant. Samme payload som ved registrering, pluss en eksplisitt agree_to_terms-boolean. Et registrantbytte oppretter en ordre og forlenger domenet med 1 år.

.fi, .be og AFNIC-toppdomenene (.fr, .re, .pm, .yt, .tf, .wf) avvises med 400 Registrant change for .fi domains must be handled by support. Please contact us. (med toppdomenet i meldingen).

PUT /dns/zones/{zone_id}/registrant-email

Oppdater e-postadressen til registranten, og slå eventuelt på WHOIS-beskyttelse.

Felt	Type	Påkrevd	Standard	Beskrivelse
email	string	Ja	ingen	Ny e-postadresse.
enable_protection	boolean	Nei	false	Hvis true, får Norid et videresendingsalias via whoisbeskyttelse.no i stedet for den ekte adressen din.

.be-domener avvises med 400 The email address of .be domains cannot be changed here. Please contact support.

PUT /dns/zones/{zone_id}/ips-tag

Overfør et .uk-domene til en annen registrar. .uk har ingen autorisasjonskode: domenet flyttes når IPS-taggen endres til taggen til den nye registraren. Ikke tilgjengelig for API-nøkler eller brukere med bare lesetilgang.

Felt	Type	Beskrivelse
tag	string	IPS-taggen til den nye registraren: bokstaver, tall og bindestrek.

Returnerer 200 The IPS tag change to TAG has been requested. The domain moves to the new registrar once the registry has processed it, usually within one working day. Feil:

• 400 A valid IPS tag is required (letters, digits and hyphens).
• 400 The domain already uses this IPS tag. Enter the IPS tag of the registrar you are moving to.
• 400 IPS tags only apply to .uk domains registered with us.
• 400 The domain cannot be transferred in its current state.
• 409 A transfer to another registrar is already in progress for this domain.
• 400 The registry rejected the IPS tag change. Check that the tag is correct, or contact support.

Navneservere

PUT /dns/zones/{zone_id}/nameservers

Oppdater navneserverne Norid har oppført for et registrert domene.

Felt	Type	Beskrivelse
nameservers	array	Minst 2 vertsnavn.

API-et verifiserer at hver kandidat er autoritativ for sonen før endringen sendes inn. external_dns-flagget på sonen oppdateres automatisk ut fra om den nye NS-listen peker mot Gigahost.

Autofornying

PUT /dns/zones/{zone_id}/auto-renew

Felt	Type	Beskrivelse
auto_renew	number	0 for å slå av, 1 for å slå på.

Autofornying styrer faktureringen. Slår du den av, krediteres en åpen fornyelsesfaktura som ikke er betalt; en fornyelse som allerede er betalt, gjennomføres likevel én gang. Slår du den på igjen, gjenopptas fornyelsen og faktureres med en gang hvis den har forfalt. meta.message sier hva som skjedde, for eksempel:

• Auto-renewal disabled. Invoice #N for the upcoming renewal has been credited. The domain will expire on DD.MM.YYYY.
• Auto-renewal disabled. The upcoming renewal is already paid, so the domain will be renewed once more and then expire on DD.MM.YYYY.
• Auto-renewal enabled. The next renewal will be invoiced on DD.MM.YYYY.
• Auto-renewal enabled. Invoice #N for the renewal until DD.MM.YYYY has been sent to you.

Feil:

Status	meta.message
403	Auto-renewal can only be modified for registered domains.
409	Auto-renewal cannot be changed while the domain is pending at the registry.
409	The domain has expired and can no longer be set to renew automatically. Please contact support to restore it.
500	Unable to credit the open renewal invoice. Auto-renewal was not changed, please contact support.

DNSSEC

GET /dns/zones/{zone_id}/ds-records

Hent DS-poster for sonen. Responsen avhenger av navneservertypen:

• Gigahost-navneservere: DS-poster på standardformat, klare til å publiseres hos foreldresonen.
• Eksterne navneservere: konfigurasjonsinstruksjoner i stedet for poster.

ds_records er en tekstblokk med én DS-post per linje (keyTag algorithm digestType digest).

GET /dns/zones/{zone_id}/ds-records/external

For eksternt hostede domener: returnerer DS-postene du tidligere har sendt inn, og requires_dnskey: true når registeret for toppdomenet krever selve den offentlige nøkkelen (.be, .ch, .cz, .de, .ee, .eu, .li og .nl).

POST /dns/zones/{zone_id}/ds-records/external

Send inn DS-poster fra de eksterne navneserverne dine til registeret. Settet du sender, erstatter postene hos registeret.

Felt	Type	Beskrivelse
ds_records	array	Liste med DS-postobjekter (under).

Hvert ds_records[i]:

Felt	Type	Beskrivelse
keyTag	number	0–65535.
alg	number	En av: 5, 7, 8, 10, 13, 14, 15, 16.
digestType	number	1 (SHA-1), 2 (SHA-256), 4 (SHA-384).
digest	string	Heksadesimal: 40 tegn for type 1, 64 for type 2, 96 for type 4.
publicKey	string	Den offentlige DNSKEY-nøkkelen, Base64. Påkrevd der requires_dnskey er true, ignoreres ellers.
keyType	number	257 (nøkkelsigneringsnøkkel, standard) eller 256 (sonesigneringsnøkkel).

Domener utenfor .no godtar bare digest-type 1 og 2: Digest type 4 is not supported for this domain. Please provide a SHA-256 (type 2) DS record. Mangler nøkkelen der den kreves: The registry for this domain requires the DNSKEY public key. Please add the public key for key tag N.

PUT /dns/zones/{zone_id}/dnssec

Slå DNSSEC på eller av for sonen.

Felt	Type	Beskrivelse
enable	number	0 for å slå av, 1 for å slå på.

Oppførselen avhenger av navneservertypen:

• Gigahost NS: nøkler opprettes automatisk og DS-poster sendes inn til registeret for deg.
• Eksterne NS: flagget settes; du sender inn dine egne DS-poster via endepunktene over.