Hopp til innhold
skribbskribb

Utviklere

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. Et .no-kjøp er en erklæring fra den som skal eie navnet, og det er ikke noe en integrasjon gjør på vegne av noen. Et domene kommer hit på én av to måter, og de svarer ulikt. Er det kjøpt gjennom skribb, ligger DNS-en hos oss, og da står dns null mens registration sier når det fornyes. Er det kjøpt et annet sted og koblet til, er det omvendt: dns viser postene du legger inn hos leverandøren din, og registration står null. Egen adresse følger med skribb Pro og begge nettsted-pakkene, men ruta svarer uansett: uten et eget domene får du domain null og skribb-adressen.

Alle sidene

Referanse

Kodeeksemplene kaller en skribb-funksjon du setter opp selv. Hent klienten for språket ditt og lim den inn én gang, så kan eksemplene under limes rett etter.

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. Det er den delen som svarer på hvorfor et domene ikke virker ennå: en post som står missing eller other, er en post som er skrevet feil eller lagt inn på feil navn. 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. Vi oversetter det ikke: en melding vi ikke har skrevet selv, er lettere å søke opp i den formen den finnes i.
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