K
Katalog API

API DökümanıAPI Documentation

30 REST uç noktası · Tam TR/EN · Yanıt zarfı {sonuc, meta}30 REST endpoints · Full TR/EN · Response envelope {sonuc, meta}

Ücretsiz API Anahtarı AlGet Free API Key Hızlı BaşlangıçQuick Start

🔑 Kimlik DoğrulamaAuthentication

Her istekte X-API-Key başlığı gönderilmelidir. Anahtarı kayıt olduktan sonra "API Anahtarım" sayfasından üretirsiniz.Send the X-API-Key header on every request. Generate a key from the "My API Key" page after signup.

X-API-Key: kt_xxxxxxxxxxxxxxxxxxxxxxxx

📦 Yanıt ZarfıResponse Envelope

Tüm uçlar tutarlı JSON yapısı döner:All endpoints return a consistent JSON structure:

{
  "sonuc": [ ... ],
  "meta": {
    "uc": "ara",
    "maliyet": 1,
    "kalan_istek": 9831,
    "sure_ms": 12
  }
}

Not: maliyet alanı bu istek için düşülen kredi miktarını gösterir. Bazı uçlarda değer sorguya göre değişebilir. Note: the maliyet field shows the credits deducted for this request. For some endpoints, the value may vary per request.

⚠️ Hata KodlarıError Codes

400 ParametreBad Request
401 AnahtarUnauthorized
402 KotaPayment Required
404 BulunamadıNot Found
429 Saatlik LimitRate Limit
500 SunucuServer Error

GENELGENERAL

2
GET /saglik Servis sağlık kontrolü. MySQL bağlantısı test edilir. Kimlik gerekmez.Service health check. MySQL connectivity is tested. No authentication required. AktifActive 0 kredicredit
Servis sağlık kontrolü. MySQL bağlantısı test edilir. Kimlik gerekmez.Service health check. MySQL connectivity is tested. No authentication required.

Örnek İstekExample Request

curl https://tecdoc.emshcloud.com/saglik

Örnek YanıtExample Response

{"servis":"katalog-api","surum":"v2","php":"8.2","zaman":"2026-09-03T10:00:00+03:00","mysql":"ok"}
GET /v1/durum Kalan istek sayısı ve müşteri bilgisi. Kota harcamaz.Returns remaining request count and customer info. Does not consume quota. AktifActive 0 kredicredit
Kalan istek sayısı ve müşteri bilgisi. Kota harcamaz.Returns remaining request count and customer info. Does not consume quota.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" https://tecdoc.emshcloud.com/v1/durum

Örnek YanıtExample Response

{"musteri_id":2,"abonelik_id":2,"kalan_istek":9832,"saatlik_limit":0}

PARÇA ARAMAPART SEARCH

2
GET /v1/ara Parça numarası veya marka+parça no ile arama. LİSTE döner: id, parça no, marka, …Search by part number or brand+part number. Returns a LIST: id, part number, bra… AktifActive 1 kredicredit
Parça numarası veya marka+parça no ile arama. LİSTE döner: id, parça no, marka, ürün adı, montaj grubu, urun_tipi_id. Girdi esnektir — "BOSCH 1 987 432 004", "BOSCH1987432004", "1987-432-004", "bosch.1987.432.004" hepsi aynı sonucu bulur. Marka önekini otomatik ayrıştırır. Detay için /v1/parca-tam çağrılır.Search by part number or brand+part number. Returns a LIST: id, part number, brand, product name, assembly group, urun_tipi_id. Input is flexible — "BOSCH 1 987 432 004", "BOSCH1987432004", "1987-432-004", "bosch.1987.432.004" all find the same result. Brand prefix is auto-parsed. For details call /v1/parca-tam.

ParametrelerParameters

kod Aranacak parça numarası. Marka önekli olabilir. Zorunlu.Part number to search. Brand prefix allowed. Required.
limit Maks. sonuç sayısı (varsayılan 50, max 200).Max results (default 50, max 200).

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/ara?kod=BOSCH%201987432004"

Örnek YanıtExample Response

{"sonuc":[{"id":504542,"parca_no":"1 987 432 004","marka_id":30,"marka_adi":"BOSCH","ad":"Filtre, kabin havasi","montaj_grubu":"Isıtma/Havalandırma","urun_tipi_id":424,"marka_slug":null}],"meta":{"uc":"ara","maliyet":1,"kalan_istek":9831,"sure_ms":12}}
GET /v1/oem OEM (Original Equipment Manufacturer) numarası ile arama. Örneğin 1K0615301K num…Search by OEM (Original Equipment Manufacturer) number. Returns all parts that r… AktifActive 1 kredicredit
OEM (Original Equipment Manufacturer) numarası ile arama. Örneğin 1K0615301K numarasını kullanan tüm parçaları döner.Search by OEM (Original Equipment Manufacturer) number. Returns all parts that reference the given OEM code (e.g. 1K0615301K).

ParametrelerParameters

kod OEM numarası. Boşluklar/tire otomatik normalize. Zorunlu.OEM number. Spaces/dashes are auto-normalized. Required.
limit Maks. sonuç sayısı.Max results.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/oem?kod=1K0615301K"

Örnek YanıtExample Response

{"sonuc":[{"id":123,"parca_no":"...","marka_adi":"BOSCH","ad":"Fren diski"}],"meta":{...}}

PARÇA DETAYPART DETAILS

10
GET /v1/parca-detay TEMEL parça bilgisi: parça no, marka, ürün adı, montaj grubu, durum_tr (Türkçe s…BASIC part info: part number, brand, product name, assembly group, durum_tr (loc… AktifActive 1 kredicredit
TEMEL parça bilgisi: parça no, marka, ürün adı, montaj grubu, durum_tr (Türkçe standart durum), marka logosu, urun_tipi_id, kategori_ids (TecDoc düğüm listesi), tr_kategori_ids (43 TR ana kategori listesi — frontend parçayı hangi menüye koyacağını bilir). OEM/kriter için ayrı uçlar.BASIC part info: part number, brand, product name, assembly group, durum_tr (localized status), brand logo, urun_tipi_id, kategori_ids (TecDoc node IDs), tr_kategori_ids (43 TR main categories — so the frontend knows which menu to place the part in). Use dedicated endpoints for OEMs/criteria.

ParametrelerParameters

id Parça ID (arama sonucundan). Zorunlu.Part ID (from a search result). Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-detay?id=504542"

Örnek YanıtExample Response

{"sonuc":{"id":504542,"parca_no":"1 987 432 004","marka_id":30,"marka_adi":"BOSCH","ad":"Filtre, kabin havasi","montaj_grubu":"Isıtma/Havalandırma","durum":"Normal","durum_tr":"Üretimde","gecerli":1,"marka_logo":"marka_logo/30.png","urun_tipi_id":424,"urun_tipi_ad":"Filtre, kabin havasi","kategori_ids":[100263,100346],"tr_kategori_ids":[2048,1657]},"meta":{...}}
GET /v1/parca-tam Bir parçanın TÜM bilgisi tek çağrıda: detay + OEM + kriter + EAN + muadil + akse…FULL part info in one call: details + OEM + criteria + EAN + replacements + acce… AktifActive 4 kredicredit
Bir parçanın TÜM bilgisi tek çağrıda: detay + OEM + kriter + EAN + muadil + aksesuar + set + not + görsel + uyumlu araç. Ayrı ayrı uçları çağırmaya gerek kalmaz. Maliyeti daha yüksek (4 kredi).FULL part info in one call: details + OEM + criteria + EAN + replacements + accessories + set + notes + images + compatible vehicles. Removes the need to call individual endpoints. Higher cost (4 credits).

ParametrelerParameters

id Parça ID. Zorunlu.Part ID. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-tam?id=504542"

Örnek YanıtExample Response

{"sonuc":{"id":504542,"parca_no":"...","oem":[...],"kriter":[...],"ean":[...],"muadil":[...],"aksesuar":[...],"set":{"icindekiler":[...],"ustler":[...]},"not":[...],"gorsel":[...],"uyumlu_arac":[...]},"meta":{...}}
GET /v1/parca-oem Parçanın OEM numaraları listesi. Her satır: oem_marka, oem_no, oem_norm.List of OEM numbers for the part. Each row: oem_marka, oem_no, oem_norm. AktifActive 1 kredicredit
Parçanın OEM numaraları listesi. Her satır: oem_marka, oem_no, oem_norm.List of OEM numbers for the part. Each row: oem_marka, oem_no, oem_norm.

ParametrelerParameters

id Parça ID.Part ID.
limit Maks sayı.Max count.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-oem?id=504542&limit=20"

Örnek YanıtExample Response

{"sonuc":[{"oem_marka":"VW","oem_no":"1K0819644B","oem_norm":"1K0819644B"},...],"meta":{...}}
GET /v1/parca-kriter Teknik kriterler: kalınlık, genişlik, yükseklik, malzeme, motor uyumluluğu vs. B…Technical criteria: thickness, width, height, material, engine compatibility, et… AktifActive 1 kredicredit
Teknik kriterler: kalınlık, genişlik, yükseklik, malzeme, motor uyumluluğu vs. Bazı kriterlerin başlığı boş olabilir (kriter_id ile eşleşir).Technical criteria: thickness, width, height, material, engine compatibility, etc. Some criteria have blank titles (matched by kriter_id).

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-kriter?id=67941"

Örnek YanıtExample Response

{"sonuc":[{"kriter_id":124,"baslik":"Kalınlık","deger":"14,3 mm","tip":"Numeric"},{"kriter_id":649,"baslik":"Fren sistemi","deger":"Lucas-Girling","tip":"Alphanumeric"}],"meta":{...}}
GET /v1/parca-muadil Eskiyen ↔ yeni parça zinciri. yon="eskiyen" — bu parça artık üretilmiyor, yerine…Superseded ↔ replacement chain. yon="eskiyen" — this part is discontinued, this … AktifActive 1 kredicredit
Eskiyen ↔ yeni parça zinciri. yon="eskiyen" — bu parça artık üretilmiyor, yerine gelen. yon="yeni" — bu parça başka bir parçanın yerini alıyor.Superseded ↔ replacement chain. yon="eskiyen" — this part is discontinued, this is its replacement. yon="yeni" — this part is the successor of another.

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-muadil?id=504542"

Örnek YanıtExample Response

{"sonuc":[{"yon":"yeni","no":"BCH826","hedef_parca_id":4298646,"hedef_no":"BHX406E","hedef_marka":"TRW"}],"meta":{...}}
GET /v1/parca-set İki yön: icindekiler (bu set ne içeriyor) + ustler (bu parça hangi setlerin/akse…Two directions: icindekiler (parts included in this set) + ustler (sets/accessor… AktifActive 1 kredicredit
İki yön: icindekiler (bu set ne içeriyor) + ustler (bu parça hangi setlerin/aksesuarın içinde).Two directions: icindekiler (parts included in this set) + ustler (sets/accessories that include this part).

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-set?id=X"

Örnek YanıtExample Response

{"sonuc":{"icindekiler":[{"ic_parca_id":123,"ic_parca_no":"...","marka_adi":"BOSCH","adet":2}],"ustler":[{"ust_parca_id":456,"ust_no":"...","cesit":"set"}]},"meta":{...}}
GET /v1/parca-aksesuar Bu parçayla birlikte kullanılan aksesuar parçalar (montaj vidası, tel, klips vs)…Accessory parts required alongside this part (mounting bolts, wire, clips, etc.)… AktifActive 1 kredicredit
Bu parçayla birlikte kullanılan aksesuar parçalar (montaj vidası, tel, klips vs).Accessory parts required alongside this part (mounting bolts, wire, clips, etc.).

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-aksesuar?id=X"

Örnek YanıtExample Response

{"sonuc":[{"aks_parca_id":789,"aks_parca_no":"...","adet":1,"marka_adi":"FEBI"}],"meta":{...}}
GET /v1/parca-not Montaj uyarıları, teknik notlar. onemli=1 kırmızı bayrak (mutlaka okuyun).Installation warnings, technical notes. onemli=1 marks a red flag (must-read). AktifActive 1 kredicredit
Montaj uyarıları, teknik notlar. onemli=1 kırmızı bayrak (mutlaka okuyun).Installation warnings, technical notes. onemli=1 marks a red flag (must-read).

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-not?id=X"

Örnek YanıtExample Response

{"sonuc":[{"tip":"Montaj","metin":"Boru sıkma torku 25 Nm","onemli":1}],"meta":{...}}
GET /v1/parca-ean Barkodlar (EAN13). Bir parça birden fazla ambalaj koduna sahip olabilir.Barcodes (EAN13). A part may carry multiple packaging codes. AktifActive 1 kredicredit
Barkodlar (EAN13). Bir parça birden fazla ambalaj koduna sahip olabilir.Barcodes (EAN13). A part may carry multiple packaging codes.

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-ean?id=X"

Örnek YanıtExample Response

{"sonuc":["4047025498364","4047025498371"],"meta":{...}}
GET /v1/parca-gorsel Sadece FİZİKSEL dosyası olan resimler. PDF/URL/eksik kayıtlar dahil değil. Her U…Only images with a PHYSICAL file. PDF/URL/missing records are excluded. Each URL… AktifActive 1 kredicredit
Sadece FİZİKSEL dosyası olan resimler. PDF/URL/eksik kayıtlar dahil değil. Her URL X-Accel-Redirect ile nginx sendfile üzerinden servis edilir.Only images with a PHYSICAL file. PDF/URL/missing records are excluded. Each URL is served through nginx sendfile via X-Accel-Redirect.

ParametrelerParameters

id Parça ID.Part ID.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/parca-gorsel?id=504542"

Örnek YanıtExample Response

{"sonuc":[{"url":"/v1/parca-gorsel-dosya?y=image/30/82020_0.webp","bicim":"webp","aciklama":"Resim"}],"meta":{...}}

ARAÇVEHICLE

10
GET /v1/arac-marka Tüm aktif araç markaları (BMW, Ford, vs). Her marka: id, ad, slug, logo, uyan_pa…All active vehicle brands (BMW, Ford, etc.). Each brand: id, ad, slug, logo, uya… AktifActive 1 kredicredit
Tüm aktif araç markaları (BMW, Ford, vs). Her marka: id, ad, slug, logo, uyan_parca_sayisi.All active vehicle brands (BMW, Ford, etc.). Each brand: id, ad, slug, logo, uyan_parca_sayisi.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" https://tecdoc.emshcloud.com/v1/arac-marka

Örnek YanıtExample Response

{"sonuc":[{"id":16,"ad":"BMW","slug":"bmw","logo":null,"uyan_parca_sayisi":250000}],"meta":{...}}
GET /v1/arac-model Markaya ait modeller. Her modelde SERİ (üst grup: "3", "GOLF", "A-SERISI"...) ve…Models for a brand. Each model has separate SERIES (parent group: "3", "GOLF", "… AktifActive 1 kredicredit
Markaya ait modeller. Her modelde SERİ (üst grup: "3", "GOLF", "A-SERISI"...) ve GÖVDE (varyant: Cabrio, Coupe, Van, Touring, Sedan, Panelvan/Van...) ayrı alanlarda döner. Frontend "3 (E46)" ve "3 (F30)" gibi 25 farklı BMW 3 modelini seri="3" altında toplar. Gövdeye göre alt filtre yapılabilir. Opsiyonel: seri=X ile sadece o serinin modellerini süz.Models for a brand. Each model has separate SERIES (parent group: "3", "GOLF", "A-SERISI"...) and BODY (variant: Cabrio, Coupe, Van, Touring, Sedan, Panelvan/Van...) fields. Frontends can group 25 different BMW 3 models under series="3". Sub-filter by body. Optional: seri=X returns only that series.

ParametrelerParameters

marka arac_marka.id. Zorunlu.arac_marka.id. Required.
seri Sadece belirli bir seri (opsiyonel). Örn: seri=3 → BMW 3 Serisi'nin tüm nesilleri.Filter to a single series (optional). e.g. seri=3 → all BMW 3 Series generations.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-model?marka=16&seri=3"

Örnek YanıtExample Response

{"sonuc":[{"id":286,"ad":"3 (E21)","tam_ad":"BMW 3 (E21)","seri":"3","govde":null,"uretim_bas":"1975-08-01","uretim_bit":"1983-08-31","uyan_parca_sayisi":250},{"id":314,"ad":"3 Cabrio (E30)","seri":"3","govde":"Cabrio","uretim_bas":"1985-12-01","uretim_bit":"1993-10-31"}],"meta":{...}}
GET /v1/arac-seri Markanın SERİ özet listesi. Her seride kaç model var, hangi gövde varyantları me…SERIES summary for a brand. Per series: model count, available body variants, pr… AktifActive 1 kredicredit
Markanın SERİ özet listesi. Her seride kaç model var, hangi gövde varyantları mevcut, üretim tarih aralığı, toplam uyan parça sayısı. Frontend "önce seri seç, sonra nesil seç" akışı için ideal.SERIES summary for a brand. Per series: model count, available body variants, production date range, total fitting parts. Ideal for a "pick series first, then generation" frontend flow.

ParametrelerParameters

marka arac_marka.id. Zorunlu.arac_marka.id. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-seri?marka=16"

Örnek YanıtExample Response

{"sonuc":[{"seri":"3","model_adet":25,"govdeler":["Cabrio","Compact","Coupe","Touring"],"uretim_bas":"1975-08-01","uretim_bit":"2026-09-03","toplam_parca":45000}],"meta":{...}}
GET /v1/arac-marka-gorsel Araç markası logosunu döner (PNG/WebP). X-Accel-Redirect ile nginx sendfile üzer…Returns vehicle brand logo (PNG/WebP). Served via nginx sendfile with X-Accel-Re… AktifActive 1 kredicredit
Araç markası logosunu döner (PNG/WebP). X-Accel-Redirect ile nginx sendfile üzerinden servis edilir. Sadece görseli olan markalar için 200 döner, yoksa 404.Returns vehicle brand logo (PNG/WebP). Served via nginx sendfile with X-Accel-Redirect. Returns 200 only for brands with a logo, 404 otherwise.

ParametrelerParameters

id arac_marka.id. Zorunlu.arac_marka.id. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-marka-gorsel?id=16" -o bmw.png

Örnek YanıtExample Response

(binary image · Content-Type: image/png)
GET /v1/arac-model-gorsel Araç model görselini döner (PNG/WebP). BMW 3 (E46), VW Golf VII gibi model bazlı…Returns vehicle model image (PNG/WebP). Model-level photo like BMW 3 (E46), VW G… AktifActive 1 kredicredit
Araç model görselini döner (PNG/WebP). BMW 3 (E46), VW Golf VII gibi model bazlı foto. X-Accel-Redirect ile servis. Görsel yoksa 404.Returns vehicle model image (PNG/WebP). Model-level photo like BMW 3 (E46), VW Golf VII. Served via X-Accel-Redirect. Returns 404 if not available.

ParametrelerParameters

id arac_model.id. Zorunlu.arac_model.id. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-model-gorsel?id=5114" -o bmw_1_e81.png

Örnek YanıtExample Response

(binary image · Content-Type: image/png)
GET /v1/arac-motor Modele ait motor/tip varyantları (KType). Motor kodu, hacim, HP, yakıt, kasa tip…Engine/type variants for a model (KType). Engine code, displacement, HP, fuel ty… AktifActive 1 kredicredit
Modele ait motor/tip varyantları (KType). Motor kodu, hacim, HP, yakıt, kasa tipi.Engine/type variants for a model (KType). Engine code, displacement, HP, fuel type, body type.

ParametrelerParameters

model arac_model.id. Zorunlu.arac_model.id. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-motor?model=123"

Örnek YanıtExample Response

{"sonuc":[{"tip":"PassengerCar","ktype":6234,"ad":"320d","motor_kodu":"M47D20","hacim_cc":1995,"guc_hp":150,"guc_kw":110,"yakit":"Dizel","kasa_tipi":"Sedan","uretim_bas":"2001-09-01","uretim_bit":"2005-04-30"}],"meta":{...}}
GET /v1/arac-uyumluluk Bir parçanın uyduğu araçların TAM teknik detayı. id=parça, döner: arac_tip, ktyp…FULL technical detail of vehicles fitting a part. id=part; returns: arac_tip, kt… AktifActive 1 kredicredit
Bir parçanın uyduğu araçların TAM teknik detayı. id=parça, döner: arac_tip, ktype, ad, tam_ad, kasa_kodu, motor_kodu, hacim_cc, silindir, guc_kw, guc_hp, yakit, cekis, kasa_tipi, uretim_bas/bit, marka + model bilgisi, bulundu_yol (bağlantının kaynağı).FULL technical detail of vehicles fitting a part. id=part; returns: arac_tip, ktype, ad, tam_ad, kasa_kodu, motor_kodu, hacim_cc, silindir, guc_kw, guc_hp, yakit, cekis, kasa_tipi, uretim_bas/bit, brand + model info, bulundu_yol (link source).

ParametrelerParameters

id Parça ID.Part ID.
limit Maks sayı.Max count.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-uyumluluk?id=504542&limit=100"

Örnek YanıtExample Response

{"sonuc":[{"arac_tip":"PassengerCar","ktype":10450,"ad":"1.4 (68)","tam_ad":"OPEL INSIGNIA A (G09) 1.4 (68)","kasa_kodu":"G09","motor_kodu":"B 14 NET","hacim_cc":1364,"silindir":4,"guc_kw":103,"guc_hp":140,"yakit":"Benzin","cekis":"Önden tahrik","kasa_tipi":"Hatchback","uretim_bas":"2011-04-01","uretim_bit":"2017-03-31","tr_gecerli":1,"marka_ad":"OPEL","model_ad":"INSIGNIA A (G09)"}],"meta":{...}}
GET /v1/arac-parca Araca uyan parçalar (sayfalı + filtreli). tip+ktype araç, kategori_id kategori, …Parts fitting a vehicle (paginated + filtered). tip+ktype vehicle, kategori_id c… AktifActive 1 kredicredit
Araca uyan parçalar (sayfalı + filtreli). tip+ktype araç, kategori_id kategori, kriter[] ve marka_id[] süzme. Her parça: id, parca_no, marka_id, marka_adi, ad, montaj_grubu, urun_tipi_id, urun_tipi, tr_kategori_ids[]. Frontend parçayı hangi TR kategoriye yerleştireceğini tr_kategori_ids ile bilir.Parts fitting a vehicle (paginated + filtered). tip+ktype vehicle, kategori_id category, kriter[] and marka_id[] filters. Each part: id, parca_no, marka_id, marka_adi, ad, montaj_grubu, urun_tipi_id, urun_tipi, tr_kategori_ids[]. Frontend uses tr_kategori_ids to place parts under TR main categories.

ParametrelerParameters

tip PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Zorunlu.PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Required.
ktype Araç ktype. Zorunlu.Vehicle ktype. Required.
kategori_id kategori.tecdoc_node_id — opsiyonel (sadece o kategoriden).kategori.tecdoc_node_id — optional (only that category).
marka_id[] Parça markası ID — birden fazla verilebilir (OR): marka_id[]=30&marka_id[]=158Part-brand ID — multi-value (OR): marka_id[]=30&marka_id[]=158
kriter[] kriter_id:deger formatında süzme. Aynı kriter için çoklu değer OR, farklı kriterler AND. Örn: kriter[]=124:15 mm&kriter[]=468:Low-MetallicFilter as kriter_id:deger. Same-criterion values OR, different criteria AND. e.g. kriter[]=124:15 mm&kriter[]=468:Low-Metallic
s Sayfa (1'den başlar). Varsayılan 1.Page (starts at 1). Default 1.
limit Sayfa boyutu (1-500). Varsayılan 50.Page size (1-500). Default 50.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-parca?tip=PassengerCar&ktype=6234&kategori_id=100030&marka_id[]=158&kriter[]=124:15%20mm&s=1&limit=20"

Örnek YanıtExample Response

{"sonuc":{"toplam":2,"sayfa":1,"limit":20,"sayfa_sayisi":1,"parcalar":[{"id":504542,"parca_no":"180169","marka_id":158,"marka_adi":"ICER","ad":"Fren balata seti","montaj_grubu":"Fren sistemi","urun_tipi_id":402,"urun_tipi":"Fren balata seti, diskli fren","tr_kategori_ids":[1172,2048]}]},"meta":{...}}
GET /v1/arac-ozellik Aracın TÜM teknik özellikleri — üretim tarihleri, kasa/motor/yakıt tipi, güç kW/…FULL technical specs of a vehicle — production dates, body/engine/fuel type, kW/… AktifActive 1 kredicredit
Aracın TÜM teknik özellikleri — üretim tarihleri, kasa/motor/yakıt tipi, güç kW/HP, silindir, valf, hacim, ağırlık, boyutlar, yakıt tüketimi, CO2, tork, lastik boyutu, KBA numaraları vs. Gruplu döner: General / TechnicalData / Body / Engine.FULL technical specs of a vehicle — production dates, body/engine/fuel type, kW/HP, cylinders, valves, displacement, weight, dimensions, fuel economy, CO2, torque, tyre size, KBA numbers, etc. Grouped: General / TechnicalData / Body / Engine.

ParametrelerParameters

tip PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Zorunlu.PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Required.
ktype Araç ktype. Zorunlu.Vehicle ktype. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/arac-ozellik?tip=PassengerCar&ktype=6234"

Örnek YanıtExample Response

{"sonuc":{"ozet":{"tip":"PassengerCar","ktype":6234,"ad":"320d","tam_ad":"BMW 3 (E46) 320d","kasa_kodu":"E46","motor_kodu":"M47D20","hacim_cc":1995,"guc_hp":150,"yakit":"Dizel"},"gruplar":{"General":[{"baslik":"Construction interval","deger":"09.2001 - 04.2005"}],"TechnicalData":[{"baslik":"Power","deger":"110 kW"},{"baslik":"Power","deger":"150 PS"}],"Body":[{"baslik":"Body type","deger":"Sedan"}],"Engine":[{"baslik":"Engine code","deger":"M47D20"}]},"toplam":24},"meta":{...}}
GET /v1/vin Şase (17 haneli VIN) ile araç tespit. Bir VIN birden fazla motor/gövde varyantı …Vehicle detection from a 17-character VIN. Checks vin_cache first; on miss, quer… KısmiPartial 1 kredicredit
Şase (17 haneli VIN) ile araç tespit. Bir VIN birden fazla motor/gövde varyantı döndürebilir; frontend müşteriye seçim yaptırır.Vehicle detection from a 17-character VIN. Checks vin_cache first; on miss, queries the live TecDoc catalog and persists the result.

ParametrelerParameters

sasi 17 haneli VIN kodu. Zorunlu.17-character VIN. Required.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/vin?sasi=WVWZZZ1KZAM123456"

Örnek YanıtExample Response

{"sonuc":{"vin":"WVW...","arac_tip":"PassengerCar","ktype":6234,"arac_adi":"BMW 3 (E46) 320d"},"meta":{"uc":"vin","maliyet":1,"kalan_istek":9830,"sure_ms":18}}

KATEGORİCATEGORY

3
GET /v1/tr-kategori 43 TR ana kategori (müşteri arayüzü için). Her kategori için tecdoc_kategori_ids…43 TR main categories (for customer UI). Each returns tecdoc_kategori_ids (linke… AktifActive 1 kredicredit
43 TR ana kategori (müşteri arayüzü için). Her kategori için tecdoc_kategori_ids (bağlı TecDoc düğümleri) ve urun_tipi_ids (bağlı genart'lar) döner — frontend haritalama için.43 TR main categories (for customer UI). Each returns tecdoc_kategori_ids (linked TecDoc nodes) and urun_tipi_ids (linked generic articles) for frontend mapping.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" https://tecdoc.emshcloud.com/v1/tr-kategori

Örnek YanıtExample Response

{"sonuc":[{"id":1,"kod":"RA1","ad":"Motor","slug":"motor","sira":1}],"meta":{...}}
GET /v1/tecdoc-kategori TecDoc'un ham arama ağacı (7 ağaç, 5.291 düğüm). Her düğüm: parent_id, seviye, t…Raw TecDoc search tree (7 trees, 5,291 nodes). Each node: parent_id, seviye, tr_… AktifActive 1 kredicredit
TecDoc'un ham arama ağacı (7 ağaç, 5.291 düğüm). Her düğüm: parent_id, seviye, tr_kategori_id, urun_tipi_ids (bağlı genart id'leri).Raw TecDoc search tree (7 trees, 5,291 nodes). Each node: parent_id, seviye, tr_kategori_id, urun_tipi_ids (linked generic-article IDs).

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" https://tecdoc.emshcloud.com/v1/tecdoc-kategori

Örnek YanıtExample Response

{"sonuc":[{"id":100001,"agac_tipi":"PassengerCar","parent_id":null,"ad":"Motor","seviye":1,"tr_kategori_id":1}],"meta":{...}}
GET /v1/kategori-parca Bir kategori düğümündeki parçalar. Kategori → ürün tipi → parça zinciri.Parts in a category node. Category → product type → part chain. AktifActive 1 kredicredit
Bir kategori düğümündeki parçalar. Kategori → ürün tipi → parça zinciri.Parts in a category node. Category → product type → part chain.

ParametrelerParameters

kategori_id kategori.tecdoc_node_id. Zorunlu.kategori.tecdoc_node_id. Required.
limit Maks sayı.Max count.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/kategori-parca?kategori_id=100270&limit=50"

Örnek YanıtExample Response

{"sonuc":[{"id":504542,"parca_no":"...","marka_adi":"BOSCH","ad":"Kabin filtresi"}],"meta":{...}}

MARKABRAND

2
GET /v1/marka-liste 780 parça markası (BOSCH, MEYLE vs). Her marka: logo, matchcode, tr_satis (Türki…780 part brands (BOSCH, MEYLE, etc.). Per brand: logo, matchcode, tr_satis (sold… AktifActive 1 kredicredit
780 parça markası (BOSCH, MEYLE vs). Her marka: logo, matchcode, tr_satis (Türkiye'de satıyor mu), parca_sayisi.780 part brands (BOSCH, MEYLE, etc.). Per brand: logo, matchcode, tr_satis (sold in Türkiye?), parca_sayisi.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" https://tecdoc.emshcloud.com/v1/marka-liste

Örnek YanıtExample Response

{"sonuc":[{"id":30,"ad":"BOSCH","matchcode":"BOSCH","slug":null,"logo":"image/30/54284_0.webp","tr_satis":1,"parca_sayisi":236933}],"meta":{...}}
GET /v1/marka-adres Marka firma künyesi (adres, telefon, e-posta, web).Brand company details (address, phone, email, website). AktifActive 1 kredicredit
Marka firma künyesi (adres, telefon, e-posta, web).Brand company details (address, phone, email, website).

ParametrelerParameters

id marka.id.marka.id.

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/marka-adres?id=30"

Örnek YanıtExample Response

{"sonuc":[{"marka_id":30,"ad1":"Robert Bosch GmbH","sehir1":"Stuttgart","telefon":"+49...","web":"bosch.com"}],"meta":{...}}

FİLTRELEME (facet)FILTERING (facet)

1
GET /v1/kriter-faseti Bir araç (+ opsiyonel kategori) için uyan parçaların KRİTER DAĞILIMI. E-ticaret …CRITERIA DISTRIBUTION of parts fitting a vehicle (+ optional category). Designed… AktifActive 2 kredicredit
Bir araç (+ opsiyonel kategori) için uyan parçaların KRİTER DAĞILIMI. E-ticaret sitesinin "sol filtre paneli" için tasarlandı — hangi kriter ne kadar çeşit değere sahip, her değerden kaç parça var. Marka faseti de gelir. Müşteri filtrelerken kaç parça kalacağını önden görür.CRITERIA DISTRIBUTION of parts fitting a vehicle (+ optional category). Designed for e-commerce "left filter panel" — how many distinct values per criterion, how many parts per value. Includes a brand facet. Lets the customer preview the remaining count as they filter.

ParametrelerParameters

tip PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Zorunlu.PassengerCar / CommercialVehicle / Motorbike / Engine / Axle. Required.
ktype Araç ktype. Zorunlu.Vehicle ktype. Required.
kategori_id kategori.tecdoc_node_id — opsiyonel (belirli bir kategoride filtreleme).kategori.tecdoc_node_id — optional (filter inside a category).

Örnek İstekExample Request

curl -H "X-API-Key: kt_xxx" "https://tecdoc.emshcloud.com/v1/kriter-faseti?tip=PassengerCar&ktype=34350"

Örnek YanıtExample Response

{"sonuc":{"toplam_parca":1370,"kategori_id":null,"markalar":[{"ad":"FEBI BILSTEIN","adet":158},{"ad":"BOSCH","adet":108}],"kriterler":[{"kriter_id":8,"baslik":"Ağırlık","birim":"kg","degerler":[{"deger":"0,005 kg","adet":11},{"deger":"0,035 kg","adet":10}]},{"kriter_id":124,"baslik":"Uzunluk","birim":"mm","degerler":[{"deger":"95 mm","adet":18}]}]},"meta":{...}}