Metadata-Version: 2.4
Name: vknsorgula
Version: 1.0.0
Summary: VKN Sorgula API icin resmi Python SDK - Vergi Kimlik Numarasi ile firma sorgulama.
Author-email: VKN Sorgula <destek@vknsorgula.net>
License-Expression: MIT
Project-URL: Homepage, https://vknsorgula.net
Project-URL: Documentation, https://vknsorgula.net/api-dokumantasyon
Project-URL: Source, https://github.com/vknsorgula/python-sdk
Keywords: vkn,vergi,sorgula,company,turkey,api,sdk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.32.0
Dynamic: license-file

# VKN Sorgula — Python SDK

[VKN Sorgula](https://vknsorgula.net) API icin resmi Python istemcisi.

## Kurulum

```bash
pip install vknsorgula
```

Gereksinim: Python 3.8+

## Kullanim

```python
from vknsorgula import VknSorgula, NotFoundError

client = VknSorgula("YOUR_API_KEY")

try:
    company = client.company("0123456789")
    print(company["unvan"])          # ORNEK FIRMA A.S.
    print(company["vergi_dairesi"])  # KADIKOY
except NotFoundError:
    print("Firma bulunamadi.")
```

### Kota bilgisi

```python
quota = client.quota()
print(quota["remaining"])
```

### Yapilandirma

```python
client = VknSorgula(
    "YOUR_API_KEY",
    base_url="https://vknsorgula.net",
    timeout=15,
)
```

## Istisnalar

| Sinif | HTTP | Aciklama |
|-------|------|----------|
| `ValidationError` | 400 | Gecersiz VKN formati |
| `AuthenticationError` | 401 | Gecersiz / eksik API anahtari |
| `NotFoundError` | 404 | Firma bulunamadi |
| `RateLimitError` | 429 | Rate limit veya kota asildi |
| `ApiError` | 5xx | Sunucu hatasi (taban sinif) |

## Lisans

MIT
