مرجع API

API الخاص بـ دورة حياة المجال

احصل على معلومات دورة حياة مفصلة للمجال بما في ذلك التسجيل والانتهاء وسجل الحالة. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.

العمليات

GET /v1/lifecycle عرض مرجع API

GET /v1/lifecycle

العملية: getDomainLifecycle الوحدات والمصادقة: 2 المصادقة مطلوبة
GET /v1/lifecycle الرصيد: 2

معاملات الاستعلام

المعامل النوع مطلوب
domain string مطلوب

حقول الرد

الحقل النوع
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

طلب مثال

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

مثال الرد

{
  "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

  • 200 OK
  • 400 طلب غير صالح
  • 401 غير مصرح
  • 402 الدفع مطلوب
  • 429 طلبات كثيرة جداً
  • 502 بوابة غير صالحة
  • 503 الخدمة غير متاحة

موارد المرجع