Domene

Publikasjon

Adressen publikasjonen svarer på, og hva som eventuelt står igjen før den virker. Ruta leser bare: den kan verken kjøpe, flytte eller si opp et domene.

Alle sidene

Kom i gang

Guider

Referanse

Referanse

Plattform

Publikasjon

Nettsted

Nyhetsbrev

Nettbutikk

Videre

Kodeeksemplene kaller en skribb-funksjon. Hent klienten for språket ditt →

GET/v1/domain

domain:read

Hent adressen publikasjonen svarer på

Venter et tilkoblet domene fortsatt, slår vi opp postene mens du spør, og state på hver post sier om vi fant den. Er domenet i drift, slår vi ikke opp noe, og postene står unchecked. Når vi ikke fram til tjenesten som kjenner statusen, svarer vi 502 domain-status-unavailable i stedet for å svare uten poster.

Svaret · 200

domainDomain | null: Domenet, eller null når publikasjonen ikke har koblet til noe eget.
skribb_urlstring: skribb-adressen. Den svarer alltid, også når et eget domene er koblet til, og innlogging og administrasjon ligger uansett her.

Svar, tilkoblet domene som venter

{
  "domain": {
    "domain": "dittfirma.no",
    "display_domain": "dittfirma.no",
    "registrar": "external",
    "status": "pending",
    "https": "pending",
    "errors": [],
    "dns": {
      "zone": "dittfirma.no",
      "apex": true,
      "records": [
        {
          "type": "ANAME",
          "name": "@",
          "value": "fallback.skribb.no",
          "state": "found",
          "observed": []
        },
        {
          "type": "TXT",
          "name": "_cf-custom-hostname",
          "value": "1f2e3d4c-…",
          "state": "missing",
          "observed": []
        }
      ],
      "www_alternative": {
        "domain": "www.dittfirma.no",
        "records": [
          {
            "type": "CNAME",
            "name": "www",
            "value": "fallback.skribb.no",
            "state": "unchecked",
            "observed": []
          }
        ]
      }
    },
    "registration": null
  },
  "skribb_url": "https://dittfirma.skribb.no"
}

Svar, domene kjøpt gjennom skribb

{
  "domain": {
    "domain": "dittfirma.no",
    "display_domain": "dittfirma.no",
    "registrar": "skribb",
    "status": "active",
    "https": "active",
    "errors": [],
    "dns": null,
    "registration": {
      "registry_status": "active",
      "expires_at": "2027-08-13T12:00:00.000Z",
      "auto_renew": true,
      "payment_state": null,
      "nameservers": ["amy.ns.cloudflare.com", "rick.ns.cloudflare.com"]
    }
  },
  "skribb_url": "https://dittfirma.skribb.no"
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/domain"

Objekter

Domain

Adressen publikasjonen svarer på, og tilstanden den er i.

Felter

domainstring: Domenet, i den formen DNS og sertifikatet bruker.
display_domainstring: Det samme navnet slik en person leser det. Skiller seg bare på et domene med norske tegn i.
registrarstring: skribb når domenet er kjøpt gjennom oss, external når det er kjøpt et annet sted og koblet til. Det avgjør hvem som holder DNS-en, og dermed hvilket av de to feltene under som er utfylt.skribbexternal
statusstring: Om adressen er i drift. pending betyr at noe fortsatt er på vei, som regel poster som ikke har rukket fram. error betyr at venting ikke hjelper.activependingerror
httpsstring: Det samme for sertifikatet. Et domene kan rute riktig noen minutter før HTTPS er på plass, og da står status active mens denne står pending.activependingerror
errorsstring[]: Det Cloudflare melder om vertsnavnet, ordrett og på engelsk.
dnsDnsPlan | null: Postene domenet trenger. null på et domene kjøpt gjennom skribb, der sonen ligger hos oss og det ikke finnes noen poster å legge inn.
registrationDomainRegistration | null: Registreringen. null på et domene kjøpt et annet sted, der vi ikke er registrar og ikke vet noe om fornyelsen.

DnsPlan

Postene et tilkoblet domene trenger. null på et domene kjøpt gjennom skribb.

Felter

zonestring: Sonen postene hører hjemme i, altså domenet du styrer hos leverandøren.
apexboolean: Om adressen er selve hoveddomenet. Det er tilfellet som krever ANAME eller ALIAS, og det som gjør www_alternative aktuelt.
recordsDnsRecord[]: Postene, slik de skal se ut.
www_alternativeDnsAlternative | null: Med bare når adressen er et hoveddomene. Da kan nettstedet ligge på www og hoveddomenet videresende dit, som enhver leverandør får til.

DnsRecord

En post du legger inn hos domeneleverandøren din, og hva vi ser der nå.

Felter

typestring: Posttypen. ANAME står bare på et hoveddomene: DNS tillater ikke CNAME der, så leverandøren må ha ANAME eller ALIAS. Har den ikke det, bruker du www_alternative i stedet.ANAMECNAMETXT
namestring: Navnefeltet slik panelet vil ha det, altså relativt til sonen, med @ for selve hoveddomenet. Limer du inn et fullt navn i et felt som venter et relativt, ender posten ett nivå for langt ute og validerer ingenting.
valuestring: Verdien posten skal peke på.
statestring: Hva oppslaget vårt så. found: posten er der. missing: ingenting svarer på det navnet ennå. other: noe annet svarer, og observed sier hva. unknown: oppslaget selv gikk ikke gjennom, så vi vet ingenting. unchecked: vi slo ikke opp, fordi domenet er i drift eller fordi posten er et alternativ du ikke har valgt.foundmissingotherunknownunchecked
observedstring[]: Det som svarte i stedet, når state er other. Tom ellers. På et hoveddomene flater leverandøren ANAME ut til adresser før de når oss, og da er dette adressene vi fant, til å sammenligne selv.

DnsAlternative

Samme nettsted på www, for en leverandør uten ANAME eller ALIAS.

Felter

domainstring: Adressen dette alternativet gjelder.
recordsDnsRecord[]: Postene for den. state står unchecked: vi slår dem ikke opp uoppfordret.

DomainRegistration

Registreringen, på et domene skribb er registrar for. null ellers.

Felter

registry_statusstring: Registerets eget ord om navnet. Alt annet enn active er et navn som er på vei ut eller ute, og ingen av dem svarer på oppslag.activeexpiredquarantinedtransferred_outdeleted
expires_atstring: Når registreringen løper ut.
auto_renewboolean: Om domenet fornyes automatisk. Verdien følger abonnementet som betaler for det.
payment_statestring | null: null når betalingen går som den skal. failing mens et avvist kort fortsatt prøves på nytt, given_up etter siste forsøk. Da står domenet til å løpe ut, og eieren må inn og ordne kortet.failinggiven_up
nameserversstring[]: Navntjenerne Norid peker navnet til. De hører til sonen vi holder for deg, og de er ikke noe du skal endre.

← Alle rutene