DEVELOPER PORTAL

REST API Dokümantasyonu

webteknoloji.net üzerinde yer alan web araçlarını programatik olarak kendi projelerinize veya botlarınıza entegre edin. JSON formatlı yanıtlar ve yüksek uptime ile API altyapımız hizmetinizde.

Genel Bakış

WebTeknoloji Web Araçları API'si, sitemizdeki tüm popüler araçların sonuçlarını JSON formatında almanızı sağlar. API istekleri HTTP/HTTPS protokolleri aracılığıyla gerçekleştirilir.

Base URL https://webteknoloji.net/api/tools

İsteklerinizde Content-Type: application/json header parametresini göndermeniz önerilir. API, istekleri JSON gövdesi (JSON body) veya standart form-data parametresi şeklinde kabul etmektedir.

Kimlik Doğrulama

Harici isteklerinizi yetkilendirmek için aktif bir API Anahtarı (API Key) kullanmanız gerekir. Bir API anahtarına sahip değilseniz, buradan başvuru formunu doldurarak ücretsiz API anahtarı alabilirsiniz.

API anahtarınızı aşağıdaki yöntemlerden herhangi biri ile gönderebilirsiniz:

1. HTTP Header Yöntemi (Önerilen) X-API-KEY: 1234567890abcdef...
2. Authorization Header Yöntemi Authorization: Bearer 1234567890abcdef...
3. URL Query Parameter Yöntemi https://webteknoloji.net/api/tools/kelime-sayaci?api_key=1234567890abcdef...

Hata Kodları ve İstek Limitleri

API'miz standart HTTP durum kodlarını (status codes) kullanır. Başarılı yanıtlar her zaman 200 OK ile döner.

Kod Tanım Açıklama
200 OK İşlem başarıyla tamamlandı. Detaylar yanıt gövdesindedir.
400 Bad Request Hatalı veya eksik veri gönderimi (örn. boş metin alanı gönderilmesi).
401 Unauthorized API Anahtarı eksik, geçersiz veya askıya alınmış durumda.
404 Not Found Belirtilen endpoint adı bulunamadı.
429 Too Many Requests Günlük istek limitine (Varsayılan olarak 500 istek) ulaşıldı. Limitler 24 saatte bir sıfırlanır.

Kod Şablonları

Farklı dillerde API entegrasyonunu kolayca yapabilmeniz için kod taslakları. 

curl -X POST "https://webteknoloji.net/api/tools/kelime-sayaci" \
  -H "X-API-KEY: api_anahtariniz_buraya" \
  -H "Content-Type: application/json" \
  -d '{"text": "WebTeknoloji.net API entegrasyonu başarıyla çalışıyor."}'

Uç Noktalar (Endpoints)

POST /kelime-sayaci

Gönderilen metnin kelime, karakter, cümle, paragraf sayısı ile tahmini okuma süresini döndürür.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
text string Evet Analiz edilecek ham metin içeriği.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "word-count",
  "data": {
    "words": 6,
    "characters": 54,
    "characters_no_spaces": 49,
    "sentences": 1,
    "paragraphs": 1,
    "read_time_minutes": 1
  },
  "message": "İşlem başarılı"
}
POST /html-minify

Gönderilen HTML kodunu sıkıştırarak, gereksiz boşlukları, satır sonlarını ve yorumları temizler.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
html string Evet Minify edilecek HTML kodu.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "html-minify",
  "data": {
    "minified_html": "<div class=\"card\"><h1>Merhaba</h1></div>",
    "original_size": 52,
    "minified_size": 39,
    "savings_percentage": 25.0
  },
  "message": "İşlem başarılı"
}
POST /json-formatlayici

Gönderilen ham JSON stringini doğrular ve okunabilir (PRETTY_PRINT) formatta süsleyerek geri döndürür.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
json string Evet Formatlanacak JSON dizgesi.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "json-format",
  "data": {
    "formatted_json": "{\n    \"name\": \"WebTeknoloji\",\n    \"active\": true\n}"
  },
  "message": "İşlem başarılı"
}
POST /base64-kodlama

Metinleri Base64 formatına şifreler (encode) veya Base64 formatındaki verileri düz metne çözer (decode).

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
text string Evet Kodlanacak veya çözülecek metin.
action string Hayır İşlem türü. encode (varsayılan) veya decode.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "base64-encode",
  "data": {
    "result": "SGVsbG8gV29ybGQ="
  },
  "message": "İşlem başarılı"
}
POST /meta-etiket-olusturucu

Web sayfalarınız için gerekli olan temel HTML ve Open Graph (Sosyal Medya) meta etiket kodlarını toplu olarak üretir.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
title string Evet Sayfa başlığı (Meta Title)
description string Evet Sayfa açıklaması (Meta Description)
url string Hayır Sayfanın tam URL'i.
image string Hayır Paylaşımlarda görünecek OG görsel linki.
author string Hayır Yazar ismi.
robots string Hayır İndeksleme kuralı (varsayılan: index, follow).

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "meta-generator",
  "data": {
    "tags": "<!-- Temel Meta Etiketleri -->\n<title>Başlık</title>\n..."
  },
  "message": "İşlem başarılı"
}
POST /robots-txt-olusturucu

Arama motoru botları için standart bir robots.txt dosyası içeriği üretir.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
sitemap string Hayır Site haritası adresi linki (XML).
delay integer/string Hayır Crawl-delay değeri (saniye).
disallowed string/array Hayır Botların girmesi engellenen dizinler (örn. `/admin/`). Tek string veya array.
allowed string/array Hayır Taranmasına özellikle izin verilen dizinler.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "robots-generator",
  "data": {
    "robots_txt": "User-agent: *\nDisallow: /admin/\nSitemap: https://..."
  },
  "message": "İşlem başarılı"
}
POST /ssl-kontrol

Belirtilen web sitesinin SSL sertifikasını sorgular. Yayıncı kuruluş, başlangıç-bitiş tarihleri ve kalan gün sayısını hesaplar.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
domain string Evet Sertifikası incelenecek alan adı (Örn: `google.com`). Protokol (`https://`) eklemeyin.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "ssl-check",
  "data": {
    "domain": "google.com",
    "is_valid": true,
    "issuer": "GTS CA 1C3",
    "valid_from": "2026-05-01 00:00:00",
    "valid_to": "2026-07-24 23:59:59",
    "days_remaining": 50,
    "subject": "CN=google.com"
  },
  "message": "İşlem başarılı"
}
POST /seo-site-analiz

Herhangi bir web sayfasını tarayarak meta etiketlerini, başlık hiyerarşisini (H1-H6), SSL/HTTPS durumunu ve temel SEO uyumluluk kriterlerini analiz eder.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
url string Evet Analiz edilmek istenen web sayfasının tam adresi (`http://` veya `https://` dahil).

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "seo-analyze",
  "data": {
    "url": "https://webteknoloji.net",
    "meta": {
      "title": "WebTeknoloji",
      "description": "..."
    },
    "headings": {
      "h1": ["..."],
      "h2": ["..."]
    },
    "checks": {
      "has_ssl": true,
      "has_title": true,
      "has_meta_desc": true,
      "has_h1": true
    },
    "seo_score": 95
  },
  "message": "İşlem başarılı"
}
POST /url-kisaltici

Uzun web adreslerinizi kaydederek webteknoloji.net üzerinden yönlenen kısa link formatına (`/go/abc12`) dönüştürür.

İstek Parametreleri (Body)

Parametre Tip Zorunlu Açıklama
url string Evet Kısaltılmak istenen uzun URL bağlantısı.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "url-shortener",
  "data": {
    "original_url": "https://www.example.com/very-long-url-path-that-is-too-long",
    "short_code": "a9B2c",
    "short_url": "https://webteknoloji.net/go/a9B2c"
  },
  "message": "İşlem başarılı"
}
GET /ip-adresi-sorgulama

İstek yapan istemcinin veya parametre olarak gönderilen herhangi bir IPv4/IPv6 adresinin ülke, şehir, servis sağlayıcı (ISP), zaman dilimi ve koordinat bilgilerini döndürür.

İstek Parametreleri (GET/Query)

Parametre Tip Zorunlu Açıklama
ip string Hayır Sorgulanacak IP adresi. Boş bırakılırsa istek yapan istemcinin IP adresi taranır.

Yanıt Örneği (JSON)

{
  "success": true,
  "tool": "ip-query",
  "data": {
    "ip": "8.8.8.8",
    "hostname": "dns.google",
    "user_agent": "Mozilla/5.0 ...",
    "location": {
      "country": "United States",
      "city": "Glenmont",
      "isp": "Google LLC",
      "timezone": "America/New_York",
      "lat": 40.7128,
      "lon": -74.0060
    }
  },
  "message": "İşlem başarılı"
}

Hemen Kendi API Anahtarınızı Alın

Geliştiriciler, öğrenciler ve teknoloji profesyonelleri için API altyapımız tamamen ücretsizdir. Başvurunuzu yaparak bugün entegrasyona başlayabilirsiniz.

API Anahtarı Başvurusu