ekap-client

EKAP API v2 programmatik istemci ve arama modülü.

Bu kütüphane, EKAP (ekap.kik.gov.tr) platformu üzerindeki ihale arama, detay sorgulama, ilanlar, şikayetler, tebligatlar ve diğer verileri doğrudan çekmek için gerekli güvenlik başlıklarını (AES şifreli istek imzalama) otomatik olarak üretir ve kolayca istek atmanızı sağlar.

Özellikler

• AES Request Signing: EKAP'ın kullandığı X-Custom-Request-* güvenlik başlıklarını dinamik ve otomatik olarak üretir.
• Proxy Yok / Kolay İstek: Karmaşık proxy rotasyonu veya gecikme mekanizmaları olmadan doğrudan ve hızlı istekler atar.
• Doğrudan Fonksiyon Desteği: Sınıf tanımlama veya ayar yapma zahmeti olmadan doğrudan fonksiyonları import edip kullanabilirsiniz.

Kurulum

Yerel olarak projenize dahil etmek için:

# ihaleal/backend dizinindeyken:
npm install ../ekap-client

NPM üzerinden kurmak için:

npm install ekap-client

Kullanım (TypeScript & ESM)

import { searchIhaleler, getIhaleDetay, EkapSearchPayload } from 'ekap-client';

// Arama kriterleri için tam tip desteği:
const searchFilters: EkapSearchPayload = {
  searchText: 'Yazılım',
  ihaleTuruIdList: [3], // Sadece Hizmet ihaleleri
  siralamaTipi: 'desc',
  paginationTake: 10
};

try {
  const result = await searchIhaleler(searchFilters);
  console.log(`Bulunan İhale Sayısı: ${result.totalCount}`);
  console.log(result.list);
} catch (error) {
  console.error('Hata:', error);
}

// İhale Detayı Sorgulama
try {
  const detay = await getIhaleDetay("bd22258c5ce8d50aef0ed7e1805d0b3ee7a1ef7a3a420642a18f7607ca7fdea1");
  console.log(detay.item.ihaleAdi);
} catch (error) {
  console.error('Hata:', error);
}

API Metotları

• searchIhaleler(overrides): Parametrelere göre ihaleleri listeler.
• getIhaleDetay(ihaleId): İhale detay bilgilerini getirir.
• getIlanlar(ihaleId): İhaleye ait ilan listesini getirir.
• getItirazenSikayetBedeli(ihaleId): İtirazen şikayet başvuru bedelini getirir.
• getTebligatAlanIstekli(ihaleId): Tebligat alan isteklileri listeler.
• getSikayetler(ihaleId): Şikayet kayıtlarını getirir.
• getDokumanIndirenler(ihaleId): Doküman indiren isteklileri listeler.
• searchIdareler(overrides): İdare araması yapar.
• getIhaleTotalCount(baslangic, bitis): Belirli tarih aralığındaki toplam ihale sayısını sorgular.
• searchItirazenSikayetler(body): Genel itirazen şikayet başvurularını sorgular.
• getDetsisAgaci(body): İdare DETSİS ağaç yapısını sorgular.
• generateSecurityHeaders(): Manuel başlık üretmek için güvenlik imzası üretir.
• ekapPost(endpoint, body): Özelleştirilmiş alt seviye API istekleri göndermek için kullanılır.