vknsorgula/php-sdk

VKN Sorgula API icin resmi PHP SDK - Vergi Kimlik Numarasi ile firma sorgulama.

v1.0.0 2026-05-31 10:16 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^9.5

MIT

• VKN Sorgula

• api
• sdk
• turkey
• company
• vergi
• vkn
• sorgula

README

VKN Sorgula API icin resmi PHP istemcisi. Vergi Kimlik Numarasi (VKN) ile firma sorgulama yapmanizi saglar.

Kurulum

composer require vknsorgula/php-sdk

Gereksinim: PHP 7.4+ ve curl, json eklentileri.

Kullanim

<?php
require 'vendor/autoload.php';

use VknSorgula\Client;
use VknSorgula\Exception\NotFoundException;
use VknSorgula\Exception\RateLimitException;

$client = new Client('YOUR_API_KEY');

try {
    $company = $client->company('0123456789');

    echo $company['unvan'];          // ORNEK FIRMA A.S.
    echo $company['vergi_dairesi'];  // KADIKOY
} catch (NotFoundException $e) {
    echo 'Firma bulunamadi.';
} catch (RateLimitException $e) {
    echo 'Limit asildi, lutfen bekleyin.';
}

Kota bilgisi

$quota = $client->quota();
echo $quota['remaining'];

Yapilandirma

$client = new Client('YOUR_API_KEY', [
    'base_url' => 'https://vknsorgula.net',
    'timeout'  => 15,
]);

Istisnalar

Sinif	HTTP	Aciklama
ValidationException	400	Gecersiz VKN formati
AuthenticationException	401	Gecersiz / eksik API anahtari
NotFoundException	404	Firma bulunamadi
RateLimitException	429	Rate limit veya kota asildi
ApiException	5xx	Sunucu hatasi (taban sinif)

Tum istisnalar VknSorgula\Exception\ApiException sinifindan turer.

Lisans

MIT