Ucuzabulan API Merkezi
REST + GraphQL Lite + API Gateway erişim uçları, entegrasyon ve dil/para birimi tercih API’leri.
Sürüm V100 SLIDER SHARE CATEGORY SEO VERIFIED
REST örnekleri
GET https://ucuzabulan.com/api/v1/search.php?q=iphone%2015%20128%20gb&mode=federated (meta.rescue ile akıllı alternatif önerisi dönebilir)
GET https://ucuzabulan.com/api/v1/search_explain.php?q=ayfon%2013&mode=federated
GET https://ucuzabulan.com/api/v1/product.php?slug=iphone-15-128gb&region_code=TR34
GET https://ucuzabulan.com/api/v1/catalog.php?q=iphone&sort=price_asc&free_shipping=1&region_code=TR34
GET https://ucuzabulan.com/api/v1/facets.php?q=iphone&category_slug=telefon&region_code=TR34
GET https://ucuzabulan.com/api/v1/offers.php?product_id=1&sort=price_asc&region_code=TR34
GET https://ucuzabulan.com/api/preferences.php?lang=en¤cy=USD&redirect=%2F
GET https://ucuzabulan.com/api/v1/mobile_bootstrap.php
GET https://ucuzabulan.com/api/v1/mobile_me.php
GET https://ucuzabulan.com/api/v1/mobile_compare.php?ids=12,34
GET https://ucuzabulan.com/api/v1/search_cluster_health.php
POST https://ucuzabulan.com/api/v1/push_offer.php (X-API-KEY ile tekil merchant offer ingest)
POST https://ucuzabulan.com/api/v1/push_offers.php (X-API-KEY + Idempotency-Key ile toplu ingest)
POST https://ucuzabulan.com/api/gateway.php {"route":"search.products","q":"iphone 15","limit":12,"mode":"federated"}
POST https://ucuzabulan.com/api/graphql_persisted.php {"key":"home.compare-strip","variables":{"ids":"12,34"}}
Makine Okunur Dokümanlar
Entegrasyon ekipleri için canlı şema ve koleksiyon uçları.
https://ucuzabulan.com/api/openapi.php· OpenAPI 3.1 JSONhttps://ucuzabulan.com/api/postman.php· Postman Collection v2.1https://ucuzabulan.com/api/sdk.php?lang=typescript· TypeScript clienthttps://ucuzabulan.com/api/sdk.php?lang=php· PHP clienthttps://ucuzabulan.com/api/sdk.php?lang=python· Python clientAuthorization: Bearer ubg_xxx· Gateway token formatı
API Gateway
POST
https://ucuzabulan.com/api/gateway.php üzerinden tokenlı route bazlı servis erişimi sunulur.{
"route": "products.show",
"slug": "iphone-15-128gb"
}
{
"route": "catalog.products",
"q": "iphone",
"free_shipping": true,
"sort": "price_asc",
"per": 12,
"region_code": "TR34"
}
{
"route": "graphql.execute",
"query": "query Gateway { compareProducts(ids: \"12,34\") { id name displayMinPrice } }"
}
{
"route": "graphql.persisted",
"query_key": "home.compare-strip"
}
Bölgesel fiyat parametresi
Katalog, ürün ve teklif uçlarında
region_code parametresi gönderildiğinde seçilen bölge ile genel teklifler birlikte döner. Böylece bölgesel görünüm açıkken veri boş kalmaz.{
"route": "catalog.products",
"q": "iphone",
"region_code": "TR34",
"sort": "price_asc"
}
GraphQL Lite
POST
https://ucuzabulan.com/api/graphql.php veya https://ucuzabulan.com/graphql/ üzerinden sorgu çalıştırılabilir.{
"query": "query ProductCard { product(slug: \"iphone-15-128gb\") { id name slug displayMinPrice offerCount offers { storeName displayPrice sponsored freeShipping } } }"
}
{
"query": "query SearchBox { searchProducts(q: \"laptop\", limit: 6) { id name slug displayMinPrice offerCount } }"
}
{
"query": "query Dashboard { site { name baseUrl currency supportedCurrencies } stores(limit: 5) { id name slug rating } }"
}
{
"query": "query CategoryShelf { categoryProducts(slug: \"telefon\", limit: 6) { id name slug displayMinPrice offerCount } storeOffers(storeId: \"1\", limit: 4) { id productName storeName displayPrice sponsored } }"
}
{
"query": "query Compare { compareProducts(ids: \"12,34\") { id name displayMinPrice offerCount } searchExplain(q: \"ayfon 13\") { q searchQ engine rewritten } }"
}
Desteklenen GraphQL kök alanları
siteproduct(id|slug)searchProducts(q, limit)· REST tarafındamode=failover|federateddesteği vardırpriceHistory(productId, days)stores(limit)compareProducts(ids)searchExplain(q, locale)categoryProducts(id|slug, limit)storeOffers(storeId|slug, limit)
Ek endpointler
https://ucuzabulan.com/api/v1/search_click.php· search sonuç click attribution endpointi (q, product_id, position, placement)https://ucuzabulan.com/api/v1/catalog.php· SKU / GTIN / MPN gruplayan katalog liste endpointi;region_codeile bölgesel teklif görünümü uygulanabilirhttps://ucuzabulan.com/api/v1/facets.php· marka / mağaza / kategori facet endpointi; response içinde bölge facetleri de dönerhttps://ucuzabulan.com/api/v1/offers.php· net toplam fiyata göre teklif listesi endpointi;region_codeile bölgesel filtrelenebilirhttps://ucuzabulan.com/api/v1/search.php·mode=failover|federatedile çok motorlu arama çalıştırılabilir; sonuçlar az isemeta.rescueiçinde zero-result kurtarma önerisi dönebilirhttps://ucuzabulan.com/api/v1/search_explain.php· cluster explain, motor denemeleri, budget telemetry, semantic + vector motor denemeleri ve preview verisi dönerhttps://ucuzabulan.com/api/v1/push_offer.php· X-API-KEY ile tekil merchant offer upsert endpointihttps://ucuzabulan.com/api/v1/push_offers.php· X-API-KEY + Idempotency-Key ile toplu merchant ingest endpointi; batch_id ve row-level sonuç dönerhttps://ucuzabulan.com/api/graphql_persisted.php· persisted GraphQL query registry endpointi (key, variables)