@dogugurdal/trapi-client

TRApi resmi JavaScript / TypeScript istemcisi. Official JavaScript / TypeScript client for TRApi.

Türkiye'ye özel REST API'leri: telefon doğrulama, TCMB döviz kuru ve altın fiyatları, iş takvimi, şirket sorgulama, IBAN/BIN/TCKN doğrulama, İslami servisler.

Turkey-specific REST APIs: phone validation, TCMB exchange rates & gold prices, business calendar, company lookup, IBAN/BIN/TCKN validation, Islamic services.

Kurulum / Install

npm install @dogugurdal/trapi-client

Node.js 18+ gereklidir (global fetch). İsterseniz options.fetch ile özel bir fetch sağlayabilirsiniz.

Requires Node.js 18+ (global fetch). You can provide a custom fetch via options.fetch.

Kimlik Doğrulama / Authentication

RapidAPI (önerilen / recommended)

import { TRApiClient } from "@dogugurdal/trapi-client";

const client = new TRApiClient({
  rapidApiKey: process.env.RAPIDAPI_KEY!,
  rapidApiHost: "turkey-phone-number-validation-api.p.rapidapi.com",
});

const result = await client.phone.validate("05301234567");
console.log(result);

Doğrudan Erişim / Direct Access (trapi.tr)

const client = new TRApiClient({
  proxySecret: process.env.TRAPI_PROXY_SECRET!,
});

Örnek Çağrılar / Example Calls

// Döviz kurları / Exchange rates
await client.market.exchangeRates("tr");

// IBAN doğrulama / IBAN validation
await client.finance.validateIban("TR330006100519786457841326");

// İş günü kontrolü / Business day check
await client.calendar.isBusinessDay("2026-04-14");

// Namaz vakitleri / Prayer times
await client.islamic.prayerTimes("Istanbul", { lang: "tr" });

// Altın fiyatları / Gold prices
await client.market.goldPrices();

// Şirket VKN sorgulama / Company VKN lookup
await client.company.vknLookup("1234567890");

// Telefon operatör tespiti / Phone operator detection
await client.phone.operator("05301234567");

Mevcut Modüller / Available Modules

| Modül / Module | Açıklama / Description | |----------------|------------------------| | client.phone | Telefon doğrulama, operatör tespiti, formatlama / Phone validation, operator detection, formatting | | client.market | TCMB döviz kurları, altın fiyatları, çevirici / TCMB exchange rates, gold prices, converter | | client.finance | IBAN, BIN, TCKN, VKN doğrulama / IBAN, BIN, TCKN, VKN validation | | client.company | VKN ile şirket sorgulama, vergi daireleri / Company lookup by VKN, tax offices | | client.calendar | Resmi tatiller, iş günleri, BIST takvimi / Holidays, business days, BIST calendar | | client.islamic | Namaz vakitleri, Hicri takvim, Kuran / Prayer times, Hijri calendar, Quran |

Lisans / License

MIT