ajaxapi (Python SDK) v2

Yeni Ajax API (https://api.ajax.ink) için Python istemcisi. Sorgular için API anahtarı ve aktif abonelik gerekir. Paket ve dokümantasyon: https://ajax.ink

v2.0.0 büyük sürümdür: eski ücretsiz/key'siz apiv2.ajaxsystems.fun adresi kapatılmıştır. Yeni taban adres https://api.ajax.ink, kimlik doğrulama ak_... API anahtarıdır.

Kurulum

pip install ajaxapi

Python 3.8+ desteklenir; ek bağımlılık yoktur.

Hızlı başlangıç

from ajaxapi import AjaxAPI

api = AjaxAPI(api_key="ak_xxxxxxxxxxxxxxxx")
sonuc = api.tc("17420629810")

print(sonuc.raw())   # tam JSON
print(sonuc.data)    # yanıttaki "data" alanı

API anahtarı ortam değişkeninden de okunur:

export AJAXAPI_KEY="ak_xxxxxxxxxxxxxxxx"

from ajaxapi import AjaxAPI
api = AjaxAPI()

API anahtarınızı panelden oluşturabilirsiniz: https://ajax.ink/keys.php

Modül fonksiyonları (eski sürüm uyumlu)

Eski sürümdeki fonksiyon adları korunmuştur:

import ajaxapi

ajaxapi.set_api_key("ak_xxxxxxxxxxxxxxxx")

sonuc = ajaxapi.tc("17420629810")
sonuc = ajaxapi.ad_soyad("MEHMET", "YILMAZ")
sonuc = ajaxapi.aile("17420629810")
sonuc = ajaxapi.aile_pro("17420629810")
sonuc = ajaxapi.tc_gsm("17420629810")
sonuc = ajaxapi.gsm_tc("5550000000")
sonuc = ajaxapi.tapu("17420629810")
sonuc = ajaxapi.adres("17420629810")
sonuc = ajaxapi.ada_parsel("İSTANBUL", "KADIKÖY")
sonuc = ajaxapi.isyeri("17420629810")
sonuc = ajaxapi.eokul("17420629810")

Her fonksiyon AjaxResult döndürür. raw() tam JSON'u, data yanıttaki data alanını verir.

İstemci sınıfı

from ajaxapi import AjaxAPI

api = AjaxAPI(
    api_key="ak_xxxxxxxxxxxxxxxx",
    timeout=30,          # saniye
    retries=3,           # 429 / 5xx / bağlantı hatalarında
    cache_enabled=False, # kişisel veri için varsayılan kapalı
)

sonuc = api.query("tc", tc="17420629810")
print(sonuc.data)

base_url varsayılanı https://api.ajax.ink'dir. Alternatif olarak https://ajax.ink/api.php de kullanılabilir.

Endpoint'ler

Hata yönetimi

from ajaxapi import AjaxAPI, AjaxApiAuthError, AjaxApiError

api = AjaxAPI(api_key="ak_xxxxxxxxxxxxxxxx")
try:
    sonuc = api.tc("17420629810")
except AjaxApiAuthError as exc:
    print("Anahtar/abonelik hatası:", exc.error)
    print("Paket:", exc.purchase_url)
except AjaxApiError as exc:
    print("API hatası:", exc)

Önemli istisnalar:

• AjaxApiAuthError — 401/403 (anahtar yok/pasif veya abonelik yok)
• AjaxApiValidationError — 400/422 (geçersiz parametre)
• AjaxApiRateLimitError — 429
• AjaxApiServerError — 5xx
• AjaxApiTimeoutError, AjaxApiConnectionError — ağ hataları

Abonelik yoksa hata mesajında ve purchase_url alanında https://ajax.ink adresi bulunur.

Toplu sorgu

sonuclar = api.batch_tc(["17420629810", "11111111110"])
for kayit in sonuclar:
    print(kayit["tc"], kayit["durum"])

Komut satırı

ajaxapi --key ak_xxxxxxxxxxxxxxxx tc 17420629810
ajaxapi --key ak_xxxxxxxxxxxxxxxx adsoyad ROKET ATAR
ajaxapi --key ak_xxxxxxxxxxxxxxxx adaparsel İSTANBUL KADIKÖY
ajaxapi --key ak_xxxxxxxxxxxxxxxx query tc --param tc=17420629810

Anahtar AJAXAPI_KEY ortam değişkeninden de alınır:

export AJAXAPI_KEY="ak_xxxxxxxxxxxxxxxx"
ajaxapi tc 17420629810

v1'den geçiş

• Taban adres https://apiv2.ajaxsystems.fun → https://api.ajax.ink
• API anahtarı zorunlu: AjaxAPI(api_key="ak_...") veya set_api_key("ak_...")
• aile_pro() artık yeni API'deki aile ucunu kullanır
• Önbellek varsayılan olarak kapalı
• requests/httpx bağımlılığı yok; sadece standart kütüphane

Lisans

MIT © 2026 Ajax Systems