VKN Sorgula — Node.js SDK

VKN Sorgula API icin resmi Node.js istemcisi.

Kurulum

npm install vknsorgula

Gereksinim: Node.js 18+ (yerlesik fetch kullanir).

Kullanim

const { VknSorgula, NotFoundError } = require('vknsorgula');

const client = new VknSorgula('YOUR_API_KEY');

(async () => {
  try {
    const company = await client.company('0123456789');
    console.log(company.unvan);         // ORNEK FIRMA A.S.
    console.log(company.vergi_dairesi); // KADIKOY
  } catch (err) {
    if (err instanceof NotFoundError) {
      console.log('Firma bulunamadi.');
    } else {
      console.error(err.message);
    }
  }
})();

ESM:

import { VknSorgula } from 'vknsorgula';

Kota bilgisi

const quota = await client.quota();
console.log(quota.remaining);

Yapilandirma

const client = new VknSorgula('YOUR_API_KEY', {
  baseUrl: 'https://vknsorgula.net',
  timeout: 15000,
});

Hatalar

| 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 | | VknSorgulaError | 5xx | Sunucu hatasi (taban sinif) |

Lisans

MIT