API referansı

Domain Yaşam Döngüsü API ürünü

Kayıt, süre sonu ve durum geçmişi de dahil olmak üzere bir alan için ayrıntılı yaşam döngüsü bilgisini alın. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.

İşlemler

GET /v1/lifecycle API referansını görüntüle

GET /v1/lifecycle

İşlem: getDomainLifecycle Krediler ve kimlik doğrulama: 2 Kimlik doğrulama gerekli
GET /v1/lifecycle Kredi: 2

Sorgu parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt alanları

Alan Tür
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

Örnek istek

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))

Örnek yanıt

{
  "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 durum kodları

  • 200 OK
  • 400 Hatalı İstek
  • 401 Yetkisiz
  • 402 Ödeme Gerekli
  • 429 Çok Fazla İstek
  • 502 Hatalı Ağ Geçidi
  • 503 Hizmet Kullanılamıyor

Referans kaynakları