API Dokümantasyonu - DNS Sorgulama ve Analiz API

Checker.TR API, uygulamalarınıza DNS sorgulama ve network analizi özellikleri entegre etmenizi sağlayan RESTful bir web servisidir. JSON formatında veri döndürür, standart HTTP metodlarını kullanır ve API key ile kimlik doğrulama yapar.

⚡

Hızlı Yanıt

Ortalama 50ms yanıt süresi

🌍

Küresel Erişim

50+ ülkede sunucu ağı

🔒

SSL Güvenliği

256-bit şifreleme

📊

JSON Formatı

Kolay parse edilebilir yapı

Kimlik Doğrulama

Tüm API isteklerinde kimlik doğrulama zorunludur. API key'inizi HTTP Header olarak göndermelisiniz:

Authorization Header
Authorization: Bearer YOUR_API_KEY_HERE

API key almak için iletişim sayfamızdan bize ulaşın veya mevcut hesabınızdan API bölümüne gidin.

Endpoint'ler

1. DNS Sorgulama

GET

https://api.checker.tr/v1/dns/lookup

Belirtilen alan adı için DNS kayıtlarını sorgular (A, AAAA, MX, TXT, NS, SOA, CNAME).

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`domain`	string	Evet	Sorgulanacak alan adı (örn: google.com)
`type`	string	Hayır	Kayıt tipi (A, MX, TXT vb.). Varsayılan: A
`nameserver`	string	Hayır	Özel DNS sunucusu (8.8.8.8 vb.)

Örnek İstek (cURL)

cURL
curl -X GET"https://api.checker.tr/v1/dns/lookup?domain=google.com&type=A" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Örnek Yanıt

JSON Response

{
  "status": "success",
  "domain": "google.com",
  "query_time": "2024-01-15T10:30:00Z",
  "records": [
    {
      "type": "A",
      "value": "142.250.80.46",
      "ttl": 300
    },
    {
      "type": "A",
      "value": "142.250.80.78",
      "ttl": 300
    }
  ],
  "nameserver": "8.8.8.8",
  "response_time_ms": 45
}
        

2. Propagation Kontrolü

GET

https://api.checker.tr/v1/dns/propagation

DNS kaydının dünya genelindeki yayılım durumunu kontrol eder. Farklı coğrafi konumlardan sorgular.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`domain`	string	Evet	Kontrol edilecek alan adı
`type`	string	Hayır	Kayıt tipi. Varsayılan: A
`expected_value`	string	Hayır	Beklenen değer (eşleşme kontrolü için)

Örnek Yanıt

Propagation Response

{
  "status": "success",
  "domain": "example.com",
  "propagation_percentage": 85,
  "checks": [
    {
      "location": "Istanbul, TR",
      "ip": "192.168.1.1",
      "status": "match",
      "response_time": 12
    },
    {
      "location": "New York, US",
      "ip": "192.168.1.1",
      "status": "match",
      "response_time": 45
    },
    {
      "location": "Tokyo, JP",
      "ip": "192.168.1.50",
      "status": "mismatch",
      "response_time": 89
    }
  ]
}
        

3. Whois Sorgulama

GET

https://api.checker.tr/v1/whois

Domain kayıt bilgilerini sorgular (kayıt tarihi, bitiş tarihi, registrar bilgileri vb.).

4. SSL/TLS Kontrolü

GET

https://api.checker.tr/v1/ssl/check

SSL sertifikası geçerliliğini ve yapılandırmasını kontrol eder.

Hata Kodları

Kod	Anlamı	Açıklama
`200`	OK	İstek başarılı
`400`	Bad Request	Eksik veya hatalı parametre
`401`	Unauthorized	Geçersiz veya eksik API key
`403`	Forbidden	Rate limit aşıldı veya erişim engellendi
`404`	Not Found	Domain bulunamadı veya kayıt yok
`429`	Too Many Requests	Çok fazla istek gönderildi
`500`	Server Error	Sunucu hatası

Rate Limiting (Kullanım Limitleri)

API'nin adil kullanımını sağlamak ve sistem stabilitesini korumak için rate limiting uygulanmaktadır:

Ücretsiz Plan: Saatte 100 istek
Pro Plan: Dakikada 1000 istek
Enterprise: Özel limitler

Rate limit aşıldığında 429 Too Many Requests hatası döner ve Retry-After header'ında beklenmesi gereken süre (saniye) belirtilir.

Fiyatlandırma

Ücretsiz

0₺/ay

Başlangıç ve test için

Saatte 100 istek
Temel DNS sorgulama
5 farklı lokasyondan propagation
E-posta desteği
SSL kontrolü

Başvur

POPÜLER

Pro

299₺/ay

Profesyonel kullanım için

Dakikada 1000 istek
Tüm DNS kayıt tipleri
50+ küresel lokasyon
Öncelikli destek
API istatistikleri
Webhook bildirimleri

Başvur

Enterprise

Özel/ay

Büyük ölçekli projeler için

Sınırsız istek
Özel endpoint'ler
SLA garantisi (%99.9)
7/24 telefon desteği
Özel entegrasyon yardımı
White-label çözümler

İletişim

Kullanım Örnekleri

PHP ile Kullanım

PHP
<?php
$apiKey = 'YOUR_API_KEY';
$domain = 'google.com';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.checker.tr/v1/dns/lookup?domain=$domain");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $apiKey"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['status'] === 'success') {
    foreach ($data['records'] as $record) {
        echo $record['value'] . "\n";
    }
}
?>

Python ile Kullanım

Python
import requests

api_key = 'YOUR_API_KEY'
domain = 'google.com'

headers = {
    'Authorization': f'Bearer {api_key}'
}

response = requests.get(
    f'https://api.checker.tr/v1/dns/lookup?domain={domain}',
    headers=headers
)

data = response.json()

if data['status'] == 'success':
    for record in data['records']:
        print(f"IP: {record['value']}, TTL: {record['ttl']}")
        

JavaScript (Node.js) ile Kullanım

JavaScript
const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const domain = 'google.com';

axios.get(`https://api.checker.tr/v1/dns/lookup?domain=${domain}`, {
    headers: {
        'Authorization': `Bearer ${apiKey}`
    }
})
.then(response => {
    console.log(response.data.records);
})
.catch(error => {
    console.error('Error:', error.response.data);
});
        

📚 Daha Fazla Bilgi

Detaylı API dokümantasyonu, SDK'lar ve webhook entegrasyonları için bizimle iletişime geçin. Postman collection ve OpenAPI (Swagger) dokümantasyonu sağlayabiliriz.

🔌 REST API

Hızlı Yanıt

Küresel Erişim

SSL Güvenliği

JSON Formatı

Kimlik Doğrulama

Endpoint'ler

1. DNS Sorgulama

Parametreler

Örnek İstek (cURL)

Örnek Yanıt

2. Propagation Kontrolü

Parametreler

Örnek Yanıt

3. Whois Sorgulama

4. SSL/TLS Kontrolü

Hata Kodları

Rate Limiting (Kullanım Limitleri)

Fiyatlandırma

Kullanım Örnekleri

PHP ile Kullanım

Python ile Kullanım

JavaScript (Node.js) ile Kullanım

📚 Daha Fazla Bilgi

API Erişimi İçin Başvurun

Profesyonel Web Araçları