domainawait API

Başlangıç

Çoğu uç nokta herkese açıktır ve kimlik doğrulama gerektirmez. Kendi verini oluşturmak veya değiştirmek için kişisel bir erişim belirtecine ihtiyacın olacak.

1. Şuradan giriş yap: https://app.domainawait.com.
2. Şuraya git: Ayarlar → API anahtarları ve bir belirteç oluştur.
3. Authorization başlığında Bearer belirteci olarak gönder.

Kimlik doğrulama

Doğrulanmış istekler bir Bearer belirteci kullanır:

Authorization: Bearer YOUR_TOKEN

Web oturumları (panel kullanır) Sanctum SPA kimlik doğrulamasıyla çerez tabanlıdır. Üçüncü taraf entegrasyonlar her zaman kişisel bir erişim belirteci kullanmalıdır.

Hız limitleri

• Herkese açık uç noktalar

  60 / min

  IP adresi başına.

• Doğrulanmış uç noktalar

  120 / min

  Kullanıcı veya belirteç başına.

Limit aşıldığında HTTP 429 ve bir Retry-After başlığı döner.

Herkese açık

• GET/v1/domains/{name}

  Bir alan adının herkese açık ayrıntılarını alın: sona erme, takipçi sayısı ve kontrol geçmişi.

• GET/v1/domains/trending

  Alan adlarını takipçi sayısına göre sıralı listeleyin. ?limit=N (1-100) destekler.

Kimlik doğrulama

• POST/v1/auth/magic-link

  E-posta ile sihirli bağlantı isteyin. Body: { email }.

• GET/v1/auth/magic-link/verify

  E-postadaki sihirli bağlantı belirtecini doğrula.

• GET/v1/auth/google/redirect

  Google OAuth akışını başlatın.

• GET/v1/auth/google/callback

  Google OAuth geri çağrı.

• POST/v1/auth/logout

  Mevcut oturumu kapat.

  Auth
• GET/v1/auth/me

  Doğrulanmış kullanıcıyı döner.

  Auth

Alan adları (doğrulanmış)

• POST/v1/domains

  İzleme listenize bir alan adı ekleyin. Body: { name, notify_days_before? }.

  Auth
• GET/v1/domains/me

  İzlediğiniz alan adlarını listeleyin.

  Auth
• PATCH/v1/domains/me/{id}

  Bir abonelik için hatırlatıcı tercihlerini güncelleyin.

  Auth
• DELETE/v1/domains/me/{id}

  Bir alan adı aboneliğini iptal edin.

  Auth

API belirteçleri

• POST/v1/tokens

  Kişisel bir erişim belirteci oluştur.

  Auth
• GET/v1/tokens

  Aktif belirteçlerini listele.

  Auth
• DELETE/v1/tokens/{id}

  Bir belirteci iptal edin.

  Auth

Örnekler

const res = await fetch("https://api.domainawait.com/v1/domains/google.com");
const domain = await res.json();
console.log(domain.follower_count);

curl https://api.domainawait.com/v1/domains/google.com

curl -X POST https://api.domainawait.com/v1/domains \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"example.com","notify_days_before":[30,7,1]}'