API-referentie

Domeinlevenscyclus API-referentie

Krijg gedetailleerde informatie over de levenscyclus van een domein, inclusief registratie, vervaldatum en statusgeschiedenis. Gebruik deze referentie om het juiste endpoint te kiezen en precies te zien wat het teruggeeft.

Bewerkingen

GET /v1/lifecycle API-referentie bekijken

GET /v1/lifecycle

Bewerking: getDomainLifecycle Credits en authenticatie: 2 Authenticatie vereist
GET /v1/lifecycle Tegoeden: 2

Queryparameters

Parameter Type vereist
domain string vereist

Antwoordvelden

Veld Type
domain string
tld string
registered string
expires string
updated string
age_days integer
expires_in_days integer
phase string
availability_reason string
registry_message string
status_flags[] string[]
status string
events[] object[]
events[] object
events[].action string
events[].date string
meta object
meta.served_by string

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/lifecycle?domain=bbc.co.uk"
const response = await fetch("https://domscan.net/v1/lifecycle?domain=bbc.co.uk", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/lifecycle?domain=bbc.co.uk",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/lifecycle?domain=bbc.co.uk", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/lifecycle?domain=bbc.co.uk")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Voorbeeldantwoord

{
  "domain": "bbc.co.uk",
  "tld": "co.uk",
  "registered": "1997-08-01T00:00:00Z",
  "expires": "2026-08-01T00:00:00Z",
  "updated": "2024-08-01T00:00:00Z",
  "age_days": 10515,
  "expires_in_days": 474,
  "phase": "active",
  "status_flags": [
    "clientTransferProhibited",
    "serverTransferProhibited"
  ],
  "status": "clientTransferProhibited serverTransferProhibited",
  "events": [
    {
      "action": "registration",
      "date": "1997-08-01T00:00:00Z"
    },
    {
      "action": "last changed",
      "date": "2024-08-01T00:00:00Z"
    },
    {
      "action": "expiration",
      "date": "2026-08-01T00:00:00Z"
    }
  ]
}

HTTP-statuscodes

  • 200 OK
  • 400 Ongeldig verzoek
  • 401 Niet geautoriseerd
  • 402 Betaling vereist
  • 429 Te veel verzoeken
  • 502 Gatewayfout
  • 503 Service niet beschikbaar

Referentiebronnen