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&currency=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ı.

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ı

Ek endpointler