/suggest

Auto-completion özelliğini sağlayan servis.

GET /services

Amaç

Girilen değere en yakın ürün isimlerini döner.

İstek Yapısı

Element	Değer
Method	GET
Headers	Authorization: Basic Base64(user:password), subscriberId: v2 Auth Token
Query Strings	query
Params	-
Body Tipi	-
Body (Zorunlu)	-
Body (İsteğe Bağlı)	-

Cevap Yapısı

Element	Değer
Olası HTTP Durum Kodları	200, 401, 500
Başarılı Cevap	data: Object{ keyword: [ strings ] }, dialog: null, errors: null

Not: Herhangi bir sonuç bulunamazsa keyword Array'i boş dönmektedir.

Olası Hata Sebepleri

Kod	Sebep
401 Unauthorized	Uygulama geneli Basic Authentication1 yöntemi kullanılmaktadır, değişmiş olabilir.
500 Internal Server Error	Uygulama ayakta olmayabilir, ElasticSearch'e erişilemiyor olabilir.

Örnekler

Örnek cURL:

curl --request GET \
  --url '.../v1/app/suggest?query=hay' \
  --header 'Authorization: Basic YmlzdxxiaXN1bWlzdQ== ' \
  --header 'Content-Type: application/json' \
  --header 'subscriberId: CE9PvDgc1reZW3NY5TsSfZQo6CAn670g' \

Örnek Başarılı (200) Cevap:

{
	"data": {
		"keywords": [
			"Hayat Paketi",
			"Hayat Mineral Paketi 2",
			"Hayat Mineral Paketi",
			"Flodex 12'li Kağıt Havlu",
			"Solo 2 Katlı Kağıt Havlu 12'li"
		]
	},
	"dialog": null,
	"errors": null
}

Örnek İzinsiz İstek (401) Cevabı:

{
	"statusCode": 401,
	"error": "Unauthorized",
	"message": "Missing or bad formatted authorization header"
}

Footnotes

1. Bkz. BiSearch İzin ve Yetkilendirme dokümanı ↩