API de Ciclo de Vida del Dominio
Obtén información detallada del ciclo de vida para un dominio incluyendo registro, expiración e historial de estado. Usa esta referencia para elegir el endpoint adecuado y ver exactamente qué devuelve.
Operaciones
GET /v1/lifecycle
GET
/v1/lifecycle
Créditos: 2
Parámetros de consulta
| Parámetro | Tipo | obligatorio |
|---|---|---|
| domain | string | obligatorio |
Campos de respuesta
| Campo | Tipo |
|---|---|
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 |
Solicitud de ejemplo
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))Respuesta de ejemplo
{
"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"
}
]
}
Códigos de estado HTTP
200OK400Solicitud incorrecta401No autorizado402Pago requerido429Demasiadas solicitudes502Puerta de enlace incorrecta503Servicio no disponible