Yöntem sürümü
Yöntem ve kaynaklar
Bu katalog kamuya açık kaynaklardan derlenmiş olgusal bilgileri gösterir. Platform pay alım satımına, yatırım turlarına ya da para toplamaya aracılık etmez; firmalar hakkında "yatırım yapın" ya da "yapmayın" yönünde görüş bildirmez.
Bu sürüm ne yapıyor?
İzmir'deki beş teknoloji geliştirme bölgesinin (Teknopark İzmir, Ege Teknopark, Dokuz Eylül Teknopark, İzmir Bilimpark, Bilişim Vadisi İzmir) internet sitelerinde yayımladığı firma listelerini okur. Teknopark dışındaki (bağımsız) şirketleri de üç yoldan bulur: konumu İzmir olan GitHub kuruluş hesapları, İzmir'deki girişim programlarının katılımcı listeleri (İzQ, EGİAD Melekleri) ve "İzmir merkezli" ya da "İzmir'de kurulan" diye anılan şirketlerin geçtiği girişim haberleri (Webrazzi, Egirişim). İzmir Ticaret Odası'nın herkese açık üye sorgusundan teknoloji faaliyet koduyla (NACE) kayıtlı şirketleri de okur. Aynı firmayı farklı kaynaklarda eşleştirir ve her firma için kaynaklı bir profil çıkarır. Her alanın hangi kaynaktan geldiği ve kaynağın hangi tarihte okunduğu profilde görünür.
Hedef, İzmir'deki teknoloji girişimlerinin en az %90'ını listelemektir. Bugün ne kadar yakın olduğumuzu kapsam kestirimi gösterir.
Kaynaklar
| Kaynak | Grup | Kayıt | Okunma tarihi |
|---|
Toplama kuralları: her sitenin robots.txt dosyasına uyulur, aynı siteye istekler en az 1,5 saniye arayla gönderilir, yalnızca herkese açık sayfalar okunur. Giriş gerektiren alanlara, doğrulama sorularına (CAPTCHA) ve kullanım şartlarının yasakladığı sitelere (ör. LinkedIn) girilmez.
GitHub: resmî GitHub API'siyle yalnız kuruluş hesapları (konumu İzmir) okunur; kişi hesapları, e-posta adresleri ve üye listeleri alınmaz. Topluluk, kulüp, üniversite, öğrenci takımı ve kişisel hesaplar kurallarla ve elle incelemeyle ayıklanır.
Kurumun kendi sitesi: her alan adının yalnız ana sayfası bir kez okunur; başlık, meta açıklama ve sitede verilen kurumsal sosyal medya ve uygulama mağazası bağlantıları alınır. Metinlerden e-posta ve telefon numaraları silinir; kişi profillerine (ör. linkedin.com/in/…) verilen bağlantılar alınmaz.
Logo: listede ve profilde gösterilen logo, kurumun kendi sitesinin ana sayfasında bildirdiği simge dosyasıdır (apple-touch-icon, simge bağlantıları, sitenin yapısal verisindeki logo ya da favicon); her dosya için sitenin robots.txt kuralına uyulur. Logo yalnız firmayı tanıtmak için küçük boyutta gösterilir; marka hakkı sahibindedir. Birden çok sitede aynı olan hazır tema simgeleri kullanılmaz. Logosunun kaldırılmasını isteyen firma profil penceresindeki formu kullanabilir.
Öne çıkanlar ve benzer firmalar: profilin başındaki kısa bakış ve öne çıkanlar, profildeki kaynaklı alanlardan ve katalog içi karşılaştırmalardan (sektördeki ortanca kuruluş yılı, çalışan sayısı bilinen firmaların ortancası, aynı faaliyet kodundaki firma sayısı) kendiliğinden yazılır. Benzer firmalar, firmaların kendi tanımlarındaki ortak terimlerden, faaliyet kodundan ve uzmanlık etiketlerinden hesaplanır; rakip listesi değildir. Bunlar puan, sıralama ya da yatırım tavsiyesi değildir.
Oda sicili: İzmir Ticaret Odası'nın üye sorgusu meslek gruplarına göre (bilişim, bilgisayar ve donanım, elektronik, telekomünikasyon, tıbbi cihaz, mesleki-bilimsel-teknik, e-ticaret) okunur. Yalnız tüzel kişiler (A.Ş., Ltd. Şti.) ve teknoloji sayılan faaliyet kodları (yazılım, veri işleme, Ar-Ge, elektronik, telekomünikasyon, tıbbi cihaz) alınır. Şahıs işletmeleri alınmaz, çünkü unvanları kişi adıdır. Açık adres saklanmaz; adresten yalnız teknoloji bölgesi ipucu çıkarılır.
Arama yöntemleri
Kataloğu besleyen her yöntem aynı sözleşmeyle tanımlanır: ne okuduğu, hangi erişim biçimiyle ve dayanakla (robots.txt, kullanım şartları), hangi alanları aldığı ve bilerek neyi almadığı, hangi parametrelerle ve ne sıklıkla yenilendiği. Her çalışma bir deftere yazılır. Defterde şunlar tutulur: süre, ağdan ya da önbellekten okunan istek sayısı, kaynak başına kayıt sayısı ve bir önceki çalışmaya göre yeni, değişen ve düşen kayıtlar. Vadesi gelen yöntemler besleme hattında yeniden çalışır. Ardından katalog derlenir, testlerden geçer ve yayımlanır.
| Yöntem | Erişim ve dayanak | Alınmayanlar | Profil | Son ağ okuması | Yenileme |
|---|
Neleri toplamıyoruz?
- Telefon, kişisel e-posta, fotoğraf ve kişi profili bağlantıları (LinkedIn vb.): kaynak sayfada olsa bile alınmaz. Kurucu adları yalnız kurumun kendi sitesinden ya da kurucunun beyanından alınır (Kişisel veri ve aydınlatma); öbür çalışanların adları yayımlanmaz. LinkedIn, Indeed ve Kariyer.net kullanım şartları otomatik okumayı yasakladığı için kullanılmaz.
- Kişi adı ya da kişisel özgeçmiş içeren tanıtım metinleri: "… tarafından kurulan", unvanlı kişi adları (Prof., Dr. vb.) ve "… yıl çalıştıktan sonra" gibi kalıplar içeren metinler profilde gösterilmez. Kuruluş yılı bu metinlerden yalnızca sayı olarak çıkarılır; metnin kendisi saklanmaz.
- Firmanın kendi yazdığı uzun tanıtım metinleri: profilde en fazla 180 karakterlik bir alıntı gösterilir, kaynağına bağlantı verilir.
Adaylar ve doğrulama
Bir şirket yalnız dijital izde (ör. GitHub) görüldüyse profili “Doğrulama bekliyor” etiketiyle yayımlanır: resmî bir listede (teknopark, program) ya da girişimin kendi beyanında görülene kadar aday sayılır. Aday profiller katalogda ve kapsam kestiriminde yer alır; profil penceresinden sahiplenme ya da kaldırma istenebilir.
Yalnız oda sicilinde görülen şirketler “Yalnız oda sicilinde” etiketi taşır. Bunlar İzmir'de kayıtlı, teknoloji faaliyet kodlu tüzel kişilerdir. Girişim tanımına uydukları başka bir kaynakla doğrulanmadı: yaş, bağımsızlık ve ölçeklenebilir ürün bilinmiyor. İki farklı oda sicil numarası hiçbir zaman tek profilde birleştirilmez.
Elle inceleme kararları (katalogdan çıkarma, hizmet/ajans ya da büyük şirket şubesi işareti) açık bir dosyada tutulur ve her derlemede yeniden uygulanır. İlk inceleme yapay zekâ yardımıyla yapılmıştır; öğrenci ekibinin doğrulamasıyla değişebilir.
Eşleştirme
Aynı firma farklı listelerde farklı adlarla geçebilir. İki kayıt şu durumlarda tek profilde birleşir: aynı alan adını paylaşıyorlarsa ya da unvandan hukuki tür (A.Ş., Ltd. Şti.) ve sondaki jenerik kelimeler (Yazılım, Teknoloji, Sanayi ve Ticaret…) atıldıktan sonra kalan marka adı aynıysa. Profilde görünen ad bu marka adıdır; resmî unvan altında ayrıca yazar. Aynı kurallar unvan eşleştirme API'sinde de kullanılabilir.
Sektör
Sektör, kaynağın kendi sektör alanı, uzmanlık etiketleri, kısa tanım ve kurumun kendi sitesindeki başlık ve meta açıklama üzerinden anahtar kelimelerle otomatik sınıflanır. Hata olabilir; girişim profilini sahiplenerek düzeltebilir.
Veri tamlığı
Veri tamlığı, bir profildeki bilginin ne kadar eksiksiz olduğunu gösterir. Bir kalite, başarı ya da yatırım puanı değildir. Bileşenler:
| Bileşen | Ağırlık |
|---|
Profilde ayrıca yüzdelik sıra görünür: firmanın veri tamlığının, aynı sektördeki profiller arasındaki yeri (100 en dolu). Web sitesi kontrolü her alan adına tek bir istekle yapılır; 2xx ve 3xx yanıt "yanıt veriyor" sayılır.
Teknogirişim Rozeti ön değerlendirmesi
Teknogirişim Rozetini Sanayi ve Teknoloji Bakanlığı verir; bu katalog rozet vermez. Profilde yalnız kamuya açık bilgilerle bir ön değerlendirme görünür. Kapsam hedefinin paydası bu tanımdır:
| Ölçüt | Bu sürümde nasıl bakılıyor? |
|---|---|
| 15 yaştan genç | Kuruluş yılı biliniyorsa; bilinmiyorsa “bilinmiyor”. |
| Bağımsız (büyük şirket şubesi değil) | Bilinen grup adları ve elle işaret. Unvandaki “Teknopark Şubesi” tek başına şube sayılmaz (girişimler Ar-Ge şubesi açar). |
| Teknoloji ve yenilik tabanlı | Sınıflanmış teknoloji sektörü, uzmanlık etiketi ya da GitHub'da kuruluş hesabı. |
| Ölçeklenebilir iş modeli | Hizmet/ajans olarak işaretlenen firmalar bu ölçütü karşılamaz sayılır. |
| KOBİ | Çalışan ve ciro verisi gelene kadar bilinmiyor; büyük şirket şubeleri hariç. |
Sonuç: hiçbir ölçüt açıkça karşılanmıyorsa ve yaş ile teknoloji ölçütleri karşılanıyorsa “tanıma uyuyor”; bir ölçüt açıkça karşılanmıyorsa “tanıma uymuyor”; geri kalanı “bilinmiyor”.
Girişimler kesiti
Katalog İzmir'deki teknoloji firmalarının tamamını tutar; bunların hepsi girişim değildir. Keşfet ekranı varsayılan olarak Girişimler kesitini gösterir (yöntem kesit-v1). Bir firma kesite girer, eğer:
- teknopark listesinde, program listesinde, GitHub kuruluş hesaplarında ya da haberde görülmüşse (yalnız oda sicilinde değilse) ya da Teknogirişim Rozeti ön değerlendirmesinde tanıma uyuyorsa;
- ve 15 yaşından büyük olduğu bilinmiyorsa (ön değerlendirme “tanıma uymuyor” değilse);
- ve büyük şirket şubesi ya da bağlı kuruluşu değilse.
Kesit dışındaki firmalar silinmez; “Tüm teknoloji firmaları” seçeneğinde görünür. Kesit bir değerlendirme değildir: yalnız kayıtlı kaynaklara ve ön değerlendirmeye dayanır. Kuruluş yılı bilinmeyen firmalarda tabloda sicil numarasından kestirilen tescil yılı “≈” işaretiyle görünür.
Yapay zekâ odağı
Her firmanın tek bir sektörü vardır; yapay zekâyı sağlıkta ya da tarımda kullanan bir firma o sektörde sayılır. Bu yüzden “Yapay zekâ ve veri” sektörü ekosistemdeki yapay zekâ çalışmasını olduğundan küçük gösterir. Odak sektörün yanına eklenen ikinci bir işarettir (yöntem odak-v1). Bir firma yapay zekâ odağı alır, eğer:
- kendi unvanında, uzmanlık etiketlerinde ya da kendi sitesinden alınan tanıtım metninde açık bir yapay zekâ ifadesi geçiyorsa: yapay zekâ, makine öğrenmesi, derin öğrenme, büyük dil modeli, bilgisayarlı görü, doğal dil işleme, yapay sinir ağı ya da İngilizce karşılıkları;
- ya da sektörü zaten “Yapay zekâ ve veri” ise.
Yalnız “AI” kısaltması yetmez (firma adında ya da alan adında rastlantıyla geçebilir); “AI destekli”, “AI-powered” gibi açık kullanımlar sayılır. “Görüntü işleme” sanayi otomasyonunda yaygın olduğu için tek başına sayılmaz. Profilde hangi alanda hangi ifadenin geçtiği kanıt olarak gösterilir. Odak, firmanın yapay zekâ ürettiğini değil, kendini bu alanda tanıttığını gösterir; bir değerlendirme değildir.
Liste ve dışa aktarma
Satırdaki ☆ işaretiyle ya da profildeki “Listeme ekle” ile kısa liste yapılır. Liste yalnız sizin tarayıcınızda saklanır; hesap açılmaz, sunucuya gönderilmez. “Paylaşma bağlantısını kopyala” listedeki firmaların kimliklerini bağlantıya yazar; bağlantıyı açan kişi listeyi görür, kendi listesi değişmez. “CSV indir” o anki kümeyi (süzgeçlerle, arama ya da listeyle) Excel'de açılan bir dosyaya yazar: ad, unvan, site, sektör, odak, bölge, kuruluş ya da tescil yılı, doğrulama, rozet ön değerlendirmesi, kaynak sayısı, veri tamlığı, profil adresi ve kaynak adları. Son satırda veri tarihi ve “yatırım tavsiyesi değildir” notu bulunur. Makine okuması için API kullanılabilir.
Kapsam kestirimi
İzmir'de toplam kaç teknoloji girişimi olduğu bilinmiyor. Kestirmek için birbirinden ayrı kaynak grupları karşılaştırılır (yakala–yeniden yakala): teknopark listeleri, GitHub kuruluş hesapları, program listeleri (İzQ, EGİAD Melekleri) ve girişim haberleri. Bir şirketin birden çok grupta görülme sıklığı, hiçbir grupta görülmeyen şirketlerin sayısını kestirmeyi sağlar.
- Üç ya da daha çok grup: log-doğrusal model. Grupların yakalanma örüntülerinin sayılarına Poisson modeli uydurulur; gruplar arası bağımlılıklar (ör. teknopark firmalarının haberlerde daha sık geçmesi) ikili etkileşim terimleriyle modellenir. Tüm terim kümeleri uydurulur ve kestirim AIC ağırlıklarıyla ortalanır (Buckland ve diğ. 1997); böylece hangi modelin doğru olduğuna dair belirsizlik de aralığa eklenir. Güven aralığı Chao'nun log-normal yöntemiyle hesaplanır.
- İki grup: Chapman kestiricisi. Gruplar bağımsız varsayılır.
- 5'ten az üyesi olan grup kestirime alınmaz. Kestirim "güvenilir" sayılmak için en az 3 grup, her grupta en az 20 şirket ve kestirimin 1,5 katından dar bir aralık gerekir.
| Katman | Gruplar | Yöntem | Elde | Kestirilen toplam (%95 aralık) | Kapsama |
|---|
GitHub yalnız yazılım yapan şirketleri yakalayabildiği için ana kestirim yazılım ve yapay zekâ katmanında yapılır. Program ve haber adları kataloğa yalnız elle inceleme kararıyla girer (İzmir'de olduğu kanıtlanmalı); karar bekleyen adlar katalogda ve kestirimde yoktur.
Veri tazeliği
Profildeki dolu her alan (ad, unvan, web sitesi, uzmanlık etiketi, kısa tanım, kuruluş yılı, konum, oda sicili, site erişimi), o alanı veren kaynağın son okunma tarihiyle eşlenir. Kaynak son 90 günde okunduysa alan doğrulanmış sayılır; hedef, alanların en az %80'inin doğrulanmış olması. Liste ve sicil kaynakları haftalık beslemede yeniden okunur; oda listeleri en geç 84 günde, kurumun kendi sitesinden alınan bilgi en geç 84 günde yenilenir. Haber ve program kaynaklarında tarih yazının tarihidir: bu alanlar yeniden doğrulanmadıkça eskir. Sektör, tescil yılı kestirimi ve Rozet gibi türetilmiş alanlar sayılmaz. Güncel oran kapsam görünümünde ve /api/v1/coverage yanıtının freshness alanında (tazelik-v1).
Değerlendirme skoru
Bu sürümde değerlendirme skoru yok. Sonraki sürümde girişimler profillerini sahiplenip yatırıma hazırlık testini doldurduğunda, skor yalnızca girişimin onayıyla ve bileşenleri ve yöntemiyle birlikte gösterilecek. Harf notu (AAA, BB gibi) kullanılmayacak.
Kişisel veri ve aydınlatma
Kurucular ve ekip. Profillerde kurucu ve kurucu ortakların yalnız adı, rolü ve bilginin alındığı sayfa ile tarihi gösterilir. Bilgi kurumun kendi web sitesinden (ekip ve hakkımızda sayfaları, sitenin yapısal verisi) ya da kurucunun kendi beyanından alınır; telefon, e-posta, fotoğraf ve kişi profili bağlantısı alınmaz. Amaç, girişimlerin kim tarafından kurulduğunu kaynaklı biçimde göstermektir. Hukuki dayanak, bilginin ilgili kişi ya da kurumu tarafından alenileştirilmiş olması ve veri sorumlusunun meşru menfaatidir (6698 sayılı Kanun m. 5/2-d ve 5/2-f). Firmanın çalışan sayısı yalnız sayı olarak gösterilir. Kurumun ekip sayfasındaki öbür çalışanların ad ve unvanı yalnız verinin doğrulanması için platform içinde tutulur; yayımlanmaz, API'de dönmez ve üçüncü kişilere aktarılmaz. Kaynak sayfa yeniden okundukça kayıtlar güncellenir: sayfadan kalkan ad bir sonraki okumada silinir. Veri sorumlusu Muhammed Enes Duran (kurucu), İzmir. Kanun'un 11. maddesindeki haklarınızı (bilgi isteme, düzeltme, silme, itiraz) profil penceresindeki formla ya da iletişim adreslerine yazarak kullanabilirsiniz; itiraz eden kişinin adı bir daha gösterilmez.
Profil sahiplenme, düzeltme ya da kaldırma formunu kullandığınızda e-posta adresiniz, rolünüz ve notunuz yalnızca talebinizi doğrulamak ve sonuçlandırmak için işlenir; üçüncü kişilerle paylaşılmaz. Formun Ekip bölümüne yazdığınız kurucu adları ve çalışan sayısı, talebiniz doğrulanıp onaylanırsa profilde ve API'de "doğrulandı" olarak yayımlanır; onaylanmazsa yayımlanmaz. Adlarını yazdığınız kurucuları bu konuda bilgilendirmeniz gerekir. IP adresiniz saklanmaz: kötüye kullanımı sınırlamak için günlük olarak özetlenmiş (geri çevrilemez) bir değeri tutulur. Talebiniz sonuçlandıktan sonra e-posta adresinizin silinmesini isteyebilirsiniz.
Kurum talep formu. Kurumlar sayfasındaki pilot ve erken erişim formunu kullandığınızda kurum adınız, e-posta adresiniz, rolünüz, isteğe bağlı kişi sayısı ve notunuz yalnızca talebinize yanıt vermek ve hangi kurumların neye ihtiyaç duyduğunu toplu olarak görmek için işlenir; üçüncü kişilerle paylaşılmaz, pazarlama listesine eklenmez. Hukuki dayanak açık rızanızdır (6698 sayılı Kanun m. 5/1). IP adresiniz saklanmaz: kötüye kullanımı sınırlamak için günlük olarak özetlenmiş (geri çevrilemez) bir değeri tutulur. Talebiniz sonuçlandıktan sonra ya da istediğiniz zaman iletişim adreslerine yazarak kaydınızın silinmesini isteyebilirsiniz.
Bir firma profilinin kaldırılmasını ya da düzeltilmesini, profil penceresindeki formdan isteyebilirsiniz.
Kullanım ölçümü. Sitenin nasıl kullanıldığını çerez kullanmadan sayıyoruz (yöntem olcum-v1): hangi sayfanın açıldığı, karşılamada hangi yolun seçildiği, hangi süzgeç türünün kullanıldığı, hangi firma profilinin açıldığı, listeye ekleme ve CSV indirme. Sunucuda yalnız gün, olay ve sayı tutulur. Çerez, kullanıcı kimliği, IP adresi, tarayıcı izi ve arama metni saklanmaz; tek tek ziyaretçi ayırt edilemez. Tarayıcınızda “Do Not Track” ya da “Global Privacy Control” açıksa hiçbir şey gönderilmez. Toplam sayılar /api/v0/olcum adresinde herkese açıktır; firma profili açılışları firma bazında yayımlanmaz.
API
Bütün uçlar, alanlar ve deneme konsolu: API belgesi (OpenAPI 3.1). Kullanım: API kullanım şartları.
Katalog, salt okunur ve ücretsiz bir API ile de erişilebilir. Okuma uçları anahtarsız da çalışır. Hesap uçları (unvan eşleştirme, dijital sinyal, bordro) ve daha yüksek kota için API anahtarı gerekir; anahtar şimdilik elle verilir, kayıt formu sonraki sürümde.
| Erişim | Uçlar | Kota (UTC gün ve ay) |
|---|---|---|
| Anahtarsız | v0 ve v1 okuma uçları | IP başına günde 200 istek |
| Anahtarlı (ücretsiz plan) | Tüm uçlar | Günde 1.000, ayda 10.000 birim. Okuma isteği 1 birim; eşleştirmede her unvan ya da çift, bordroda her hesap ya da çizelge ayı 1 birim. |
Anahtar Authorization: Bearer gpk_… ya da X-API-Key: gpk_… başlığıyla gönderilir; adres satırında kabul edilmez. Her yanıtta RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset (gün sonuna saniye), anahtarlı isteklerde ayrıca X-Quota-Month-Remaining başlığı döner. Kota dolunca yanıt 429 ve Retry-After olur. Anahtarın kendisi saklanmaz, yalnız özeti tutulur. Anahtarsız isteklerde IP adresi saklanmaz; kota için günlük tuzla özetlenmiş, ertesi gün silinen bir değer tutulur.
v1, arama yöntemlerini ve çalışma defterini de açar. Firma sorgusunda virgülle ayrılmış değerler aynı süzgeçte “ya da”, farklı süzgeçler “ve” ile birleşir.
| Uç nokta (v1) | Açıklama |
|---|---|
GET /api/v1/companies?q=§or=&zone=&district=&stage=&verification=&rozet=&group=&method=&source=&nace=&has=&minCompleteness=&sort=&facets=1 | Genişletilmiş sorgu. verification: listed, candidate, registry. group: teknopark, dijital, program, haber, sicil. nace: kod öneki (ör. 62,63.1). has: website, github, founded, siteActive, registry ve diğerleri. sort: name, completeness, founded, sources; başına - konursa ters sıralanır. facets=1 süzülmüş kümenin dağılımlarını da döner. |
GET /api/v1/companies/{id} | Tek profil; her kaynağın yöntemi ve grubu, sicil kimlikleri |
GET /api/v1/methods, /methods/{id} | Arama yöntemleri: erişim ve dayanak, alınan ve alınmayan alanlar, parametreler, vade, verim, son 20 çalışma |
GET /api/v1/runs?method=&status= | Çalışma defteri: süre, istek sayısı, yeni, değişen ve düşen kayıtlar |
GET /api/v1/sources, /coverage, /facets | Kaynaklar, kapsam kestirimi, katalog geneli dağılımlar |
POST /api/v1/match/normalize | Unvan → marka adı, hukuki tür, marka anahtarı, tam unvan anahtarı. Tek istekte en fazla 50 unvan. Anahtar ister. |
POST /api/v1/match/pair | İki kayıt → eşleşme kararı, kural puanı ve gerekçe. Tek istekte en fazla 20 çift. Anahtar ister. |
GET /api/v1/signals/{alan-adı}, POST /api/v1/signals | Dijital sinyal: site erişimi, teknolojiler (içerik yönetimi, e-ticaret, ön yüz çatısı, analitik, canlı destek, ödeme, barındırma), ürün sinyalleri (fiyatlandırma, uygulamaya giriş, deneme/demo, API belgesi), uygulama mağazası ve kurumsal sosyal hesaplar. Toplu istekte en fazla 50 alan adı; her alan adı bir birim. Anahtar ister. Yalnız katalogdaki firmalar; istek üzerine siteye gidilmez. |
GET /api/v1/payroll/rules?period= | Bordro ve mevzuat kuralları: asgari ücret, SGK oranları ve sınırları, gelir vergisi tarifesi, istisnalar, Ar-Ge teşvikleri. Her kural kaynağı ve doğrulama durumuyla. Anahtarsız. |
POST /api/v1/payroll/calculate | Aylık bordro, brütten nete ya da netten brüte: SGK ve işsizlik kesintileri, kümülatif matrahla gelir vergisi, asgari ücret istisnası, damga vergisi, işveren maliyeti. Tek istekte en fazla 20 hesap; her hesap bir birim. Anahtar ister. |
POST /api/v1/payroll/schedule | Yıllık çizelge: her ay aynı brüt ya da aynı net için ay ay bordro ve yıl toplamları. Her ay bir birim. Anahtar ister. |
Unvan eşleştirme. Katalogu kuran eşleştirme kuralları dışarıya açılır: kendi müşteri ya da tedarikçi listenizi oda sicili ve teknopark kayıtlarıyla aynı kurallarla birleştirebilirsiniz. İstek gövdesi kaydedilmez; yalnız anahtar başına birim sayılır. Katalogda arama yapılmaz, yalnız gönderdiğiniz kayıtlar karşılaştırılır.
normalize her unvan için şunları döner: brand (profilde görünen marka adı; şube eki atılır), legalForm (A.Ş., Ltd. Şti. ya da boş), brandKey (marka adının katlanmış, boşluksuz hali; İngilizce jenerik ekler de atılır), legalKey (hukuki tür ve “sanayi ve ticaret” kalıpları dışındaki tam unvan), branch (şube unvanı mı) ve usable (anahtarın eşleştirmede kullanılacak kadar uzun olup olmadığı).
pair kaydında alanlar: name, legalName, website, chamber ve odaSicil (oda belirtilmezse İZTO sayılır). Karar, katalogu derleyen hattın kendisinden alınır; puan kuralın gücünü gösterir, olasılık değildir.
| Kural | Puan | Koşul |
|---|---|---|
registry | 100 | Aynı odada aynı sicil numarası: aynı tüzel kişi. |
domain | 95 | Aynı alan adı (sosyal ağ ve barındırma adresleri sayılmaz). |
legalKey | 90 | İki unvanda da hukuki tür var ve tam unvan anahtarı aynı (en az 8 karakter). |
brandKey | 85 / 75 | Marka anahtarı aynı: en az 4 karakter, kayıtlardan biri oda sicilinden geliyorsa en az 5. Dört karakterlik anahtar 75 puan. |
branch | 92 | İki farklı sicil kaydı aynı tüzel kişinin merkezi ve şubesi (ya da iki şubesi): hukuki türden sonrası atılmış çekirdek unvan aynı, ikisi birden merkez değil. Şube ayrı tüzel kişi değildir. Katalogda bu kayıtlar tek profilde sicil birimi olarak durur. |
prefix | 70 | Sicil dışındaki kaydın adı (en az 8 karakter) sicil kaydının unvanının öneki: "Navixus Marine" ↔ "Navixus Marine Gemi Yat Tasarımı … Ltd. Şti.". Katalogda ek şart: önek bütün sicilde tek bir tüzel kişiye uymalı ve o tüzel kişi başka bir kayıtla birleşmemiş olmalı. pair katalogu sınamadığı için puan düşük. |
acronym | 65 | Ad unvanın ilk sözcüğü, alan adı ilk sözcük ve sonraki sözcüklerin baş harfleri: "YADA", yadabt.com ↔ "Yada Bilgi Teknolojileri A.Ş.". Katalogdaki ek şart prefix ile aynı. |
| Engel | 0 | İki farklı oda sicili iki farklı tüzel kişidir; ad ya da alan adı tutsa da birleşmez. Oda numaraları odaya özgüdür: başka odadaki aynı numara başka firmadır. İstisna, aynı tüzel kişinin merkez ve şube kayıtlarıdır (aşağıda branch). Derleme hattının diğer engelleri de (ör. hukuki türü belli iki unvanın farklı tüzel kişileri anlatması) gerekçede block olarak yazılır. Hukuki türleri farklı iki unvan (A.Ş. ↔ Ltd. Şti.) yalnız tür değişikliğiyse aynı kişidir: unvanın geri kalanı aynı kalmalı. |
Birden çok kural tutarsa her ek kural 3 puan ekler (en çok 99). İki kaydın alan adı farklıysa puan 10 düşer, karar değişmez. Eşleşmeyen çiftte aynı ama kısa bir anahtar varsa puan 40 (marka) ya da 50 (tam unvan) olur ve gerekçede weak olarak görünür. Katalog derlemesi ayrıca geçişlidir (A ile B, B ile C eşleşirse üçü bir profil olur); pair yalnız iki kaydı karşılaştırır.
curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/match/normalize \
-H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
-d '{"names": ["Aegean AI Core Yazılım ve Teknoloji Ltd. Şti.", "BPM BİLİŞİM ANONİM ŞİRKETİ"]}'
{"count": 2, "units": 2, "items": [
{"input": "Aegean AI Core Yazılım ve Teknoloji Ltd. Şti.", "brand": "Aegean AI Core", "legalForm": "Ltd. Şti.",
"brandKey": "aegeanaicore", "legalKey": "aegeanaicoreyazilimteknoloji", "branch": false,
"usable": {"brandKey": true, "brandKeyRegistry": true, "legalKey": true}},
{"input": "BPM BİLİŞİM ANONİM ŞİRKETİ", "brand": "Bpm", "legalForm": "A.Ş.", "brandKey": "bpm", "legalKey": "bpmbilisim", …}],
"matchVersion": "match-v1.2", "methodVersion": "v0.1", "notice": "…"}
curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/match/pair \
-H "X-API-Key: gpk_…" -H "content-type: application/json" \
-d '{"pairs": [{"a": {"name": "BPM", "legalName": "Bpm Bilişim A.Ş."},
"b": {"legalName": "BPM BİLİŞİM ANONİM ŞİRKETİ", "chamber": "İZTO", "odaSicil": "12345"}}]}'
{"count": 1, "units": 1, "items": [{"match": true, "score": 90, "rule": "legalKey", "reasons": [
{"rule": "legalKey", "outcome": "match", "value": "bpmbilisim", "text": "Aynı tam unvan (…)."},
{"rule": "brandKey", "outcome": "weak", "value": "bpm", "text": "Marka anahtarı aynı ama kısa (3 < 5, sicil kaydında) …"}]}], …}
Dijital sinyal. Katalogdaki bir firmanın kendi ana sayfasından okunmuş sinyaller: site yanıt veriyor mu, hangi teknolojiler kullanılıyor, fiyatlandırma, uygulamaya giriş, deneme ya da API belgesi gibi ürün sinyalleri var mı. Ana sayfa en çok 90 günde bir, robots.txt'e uyularak okunur; istek üzerine siteye gidilmez, sayfa metni saklanmaz. WordPress yönetim girişi ve tanıtım sayfası yolları ürün sinyali sayılmaz; e-ticaret sitesindeki giriş ve kayıt müşteri hesabı sayılır, ürün kanıtı sayılmaz.
curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/signals \
-H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
-d '{"domains": ["ornek.com.tr", "https://www.baska-firma.com/"]}'
{"count": 2, "units": 2, "found": 1, "items": [
{"domain": "ornek.com.tr", "found": true, "companies": [{"id": "ornek", "site": {"ok": true, "status": 200, …},
"tech": [{"id": "wordpress", "label": "WordPress", "cat": "cms"}, …],
"product": {"pricing": "/fiyatlar", "login": "//app.ornek.com.tr"}, "productEvidence": ["fiyatlandırma sayfası", "uygulamaya giriş"], …}]},
{"domain": "baska-firma.com", "found": false, "companies": []}], "signalVersion": "sinyal-v0.1", …}
Bordro ve mevzuat. 2026 kurallarıyla, 4/a kapsamında tam ay çalışan biri için aylık bordro. Gelir vergisi kümülatif matrahla hesaplanır; önceki matrah (priorTaxBase) verilmezse çalışanın işe başladığı aydan (startMonth) beri her ay aynı tutarı aldığı varsayılır ve yanıtta yazılır. Seçenekler: incentive (5510 m. 81/1-ı Hazine prim desteği: general 2 puan, manufacturing imalat için 5 puan), disability (engellilik derecesi 1–3) ve rnd (Ar-Ge: teknoloji geliştirme bölgesi için {"law": "4691"}, Ar-Ge ve tasarım merkezi için {"law": "5746", "education": "phd"}; education phd, masters, bachelors ya da other, desteklenecek program alanındaki derece için "priorityField": true).
Her kural /payroll/rules yanıtında kaynağı ve durumuyla durur: dogrulandi (resmî yayında okundu), ikincil (birbirini tutan ikincil kaynaklar) ya da yorum (kural metni okundu, uygulama ayrıntısı mali müşavir doğrulaması bekliyor; şimdilik yalnız Ar-Ge sigorta primi desteği). Hesap, resmî örneklerle sınanır: GİB'in asgari ücret tablosu ve 331 Seri No.lu Gelir Vergisi Genel Tebliği'nin Ar-Ge hesap örnekleri kuruşu kuruşuna tutar. Ar-Ge gelir vergisi teşviki çalışandan kesilen vergiden işverence terkin edilir; çalışanın netini değil işveren maliyetini düşürür. Kapsam dışı: kısmi ay, emekli çalışan (SGDP), birden çok işveren, yemek ve yol yardımı, BES, kıdem tazminatı. Sonuç bilgi amaçlıdır; bordro ya da vergi danışmanlığı değildir.
curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/payroll/calculate \
-H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
-d '{"items": [{"period": "2026-10", "gross": 100000, "incentive": "general"}]}'
{"count": 1, "units": 1, "items": [{"period": "2026-10",
"employee": {"gross": 100000, "sgk": 14000, "unemployment": 1000, "taxBase": 85000, "priorTaxBase": 765000,
"marginalRatePct": 27, "incomeTaxCalculated": 22950, "minWageExemption": 5615.1, "incomeTax": 17334.9,
"stampTax": 508.3, "net": 67156.8, …},
"employer": {"sgk": 21750, "unemployment": 2000, "incentive5510": 2000, "cost": 121750, …},
"assumptions": ["…", "Önceki matrah verilmedi: 1. aydan beri her ay aynı brüt ödendiği varsayıldı (kümülatif matrah 765.000,00 TL).", …]}],
"bordroVersion": "bordro-v1", "rulesChecked": "2026-10-19", "notice": "…"}
| Uç nokta (v0, değişmez) | Açıklama |
|---|---|
GET /api/v0 | Sürüm, uç noktalar, uyarı metni |
GET /api/v0/companies?q=§or=&zone=&stage=&verification=&sort=&limit=&offset= | Süzülmüş liste (en fazla 500 kayıt). stage: yerleşik, kuluçka, bağımsız; verification: listed, candidate; sort: name, completeness, founded |
GET /api/v0/companies/{id} | Tek profil: alanlar, kaynaklar, alan bazında kaynak kaydı, veri tamlığı bileşenleri |
GET /api/v0/stats | Toplamlar, sektör, bölge ve Rozet dağılımı, kapsam kestirimi, kaynaklar |
Sürüm günlüğü
- v0.1 (Ekim 2026): Teknopark İzmir ve Ege Teknopark (yerleşik ve kuluçka) listeleri, eşleştirme, sektör sınıflaması, veri tamlığı, web sitesi kontrolü, profil sahiplenme formu, API v0.
- v0.1 + S1 (17 Ekim 2026): teknopark dışı adaylar (GitHub kuruluş hesapları), “Doğrulama bekliyor” etiketi, kurumun kendi sitesinden meta bilgi ve kurumsal bağlantılar, Teknogirişim Rozeti ön değerlendirmesi, kapsam kestirimi.
- v0.1 + S2 (18 Ekim 2026): İzmir Bilimpark ve Bilişim Vadisi İzmir firma listeleri; program grubu (İzQ programları, EGİAD Melekleri) ve haber grubu (Webrazzi, Egirişim); log-doğrusal kapsam kestirimi (AIC ağırlıklı model ortalaması).
- v0.1 + S3 (18 Ekim 2026): arama yöntemleri sözleşmesi ve çalışma defteri; besleme hattı; oda sicili grubu (İzmir Ticaret Odası üye sorgusu, teknoloji NACE kodları); İlçe ve Kaynak grubu süzgeçleri; API v1.
- v0.1 + API anahtarı (18 Ekim 2026): API anahtarı ve kota (anahtarsız okuma IP başına günde 200 istek); unvan eşleştirme uçları
match/normalizevematch/pair. - v0.1 + dijital sinyal (18 Ekim 2026): kurumun kendi ana sayfasından teknoloji izleri ve ürün sinyalleri (fiyatlandırma, uygulamaya giriş, deneme/demo, API belgesi); Rozet ön değerlendirmesinde "ölçeklenebilir iş modeli" bu sinyallerle değerlendirilir (rozet-v0.2);
/api/v1/signals. - v0.1 + merkez ve şube (18 Ekim 2026): aynı tüzel kişinin oda sicilindeki merkez ve şube kayıtları tek profilde birleşir; şubeler profilde sicil kaydı olarak görünür, eski adresler yeni profile yönlenir. Tescil yılı kestirimi yalnız merkez kaydının numarasıyla yapılır (sicil-yili-v0.2); unvan eşleştirme API'sinde yeni
branchkuralı (match-v1.1). - v0.1 + bordro (19 Ekim 2026): bordro ve mevzuat API'si (
/api/v1/payroll): 2026 kuralları kaynaklarıyla, brütten nete ve netten brüte aylık hesap, yıllık çizelge, işveren maliyeti, 5510 prim desteği, engellilik indirimi ve Ar-Ge teşvikleri (bordro-v1). - v0.1 + eşleştirme düzeltmeleri (20 Ekim 2026): listede yalnız marka ya da kısaltılmış unvan yazan firma, unvanı bu adla başlayan tek sicil kaydıyla birleşir (9 firma); alan adı kısaltması; hukuki türü farklı iki unvan yalnız tür değişikliğiyse aynı kişi; aynı kısa adla görünen farklı tüzel kişilerin adı unvandaki sonraki sözcükle ayrışır ("Egem Endüstriyel", "Egem Yazılım"); eşleştirme API'sinde
prefixveacronymkuralları (match-v1.2). - v0.1 + veri tazeliği (20 Ekim 2026): son 90 günde doğrulanmış alan oranı kapsam görünümünde ve
/api/v1/coverageyanıtında (tazelik-v1). - v0.1 + API belgesi (24 Ekim 2026): OpenAPI 3.1 belgesi (
/api/v1/openapi.json), API belge sayfası ve deneme konsolu, API kullanım şartları; Torbalı Ticaret Odası üye listesi.