Apiservisim Python SDK

Apiservisim'in Türkçe API'lerine Python ile erişmek için küçük, bağımlılıksız istemci.

pip install apiservisim komutu paket PyPI'da yayımlandıktan sonra kullanılabilir. Şu anki kaynak koduyla kurmak için aşağıdaki yerel kurulumu kullanın.

Kurulum

python -m pip install .

Bu komutu python-sdk klasöründe çalıştırın. Python 3.10 veya üzeri gerekir.

Kullanım

from apiservisim import ApiServisim

api = ApiServisim()

# Genel bir endpoint: kısa yol veya /api/... biçimi kullanılabilir.
doviz = api.get("doviz")
haberler = api.get("/api/haberler", params={"adet": 5})

print(doviz)
print(haberler)

JSON yanıtları Python nesnesi olarak döner. Görsel veya video gibi JSON olmayan yanıtlar bytes olarak döner. GET ve POST dışında bir HTTP metodu gerekirse request kullanılabilir:

sonuc = api.request("DELETE", "/api/ornek", params={"id": 123})

T.C. Kimlik No Kontrol API'si

import os
from apiservisim import ApiServisim

sonuc = ApiServisim().tckimlik(
    tc=os.environ["TC_KIMLIK_NO"],
    ad=os.environ["KISI_ADI"],
    soyad=os.environ["KISI_SOYADI"],
    dogum_yili=1990,
)
print(sonuc)

Bu endpoint yalnızca yerel biçim ve kontrol basamağı algoritmasını çalıştırır. NVI/MERNİS bağlantısı yoktur ve gerçek bir kişinin kimliğini doğrulamaz. Gerçek kişisel verileri GET URL'sine koymayın veya günlüklerde saklamayın; örnekteki tckimlik metodu POST JSON kullanır.

Özel sunucu adresi, zaman aşımı ve hatalar

from apiservisim import ApiServisim, ApiServisimHTTPError

api = ApiServisim(
    base_url="https://apiservisim.vercel.app",
    timeout=20,
)

try:
    sonuc = api.get("saat", params={"sehir": "İstanbul"})
except ApiServisimHTTPError as hata:
    print(hata.status_code, hata.body)

ApiServisimConnectionError, bağlantı ve zaman aşımı sorunlarında; ApiServisimHTTPError ise API'nin 4xx/5xx yanıtlarında yükseltilir. Yanıt gövdesi JSON değilse ApiServisimHTTPError.body metin olarak kullanılabilir.

SOAP uyumluluk endpoint'ine ham gövde göndermek için:

xml = "<soap:Envelope>...</soap:Envelope>"
yanit = api.post(
    "/Service/KPSPublic.asmx",
    data=xml,
    headers={"Content-Type": "text/xml"},
)

Geliştirme ve test

python -m unittest discover -s tests -v
python -m pip install .

SDK yalnızca Python standart kütüphanesini kullanır; requests veya httpx kurulumu gerekmez.