/services

Full-text search hizmeti sunan servis.

POST /services

Amaç

İstenilen servise göre girilen arama teriminin sonucunu üretmek

İstek Yapısı

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

Cevap Yapısı

Element	Değer
Olası HTTP Durum Kodları	200, 400, 401, 500
Başarılı Cevap	data: Object{ services: [ Object { service: String, productNumbers: Array[String], brands: Array[String] } ] }, dialog: null, errors: null

Olası Hata Sebepleri

Kod	Sebep
400 Bad Request	Body'de bir eksiklik veya JSON notasyonuna uymayan bir ifade olabilir, Header'da subscriberId gönderilmemiş olabilir.
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 POST \
  --url '.../v1/app/services?query=erikli' \
  --header 'Authorization: Basic YmlzdxxiaXN1bWlzdQ== ' \
  --header 'Content-Type: application/json' \
  --header 'subscriberId: CE9PvDgc1reZW3NY5TsSfZQo6CAn670g' \
  --data '{
	"services": ["biri"]
    }'

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

{
	"data": {
		"services": [
			{
				"service": "biri",
				"productNumbers": [
					"15ivrg19iu",
					"a1i9o9fkaf"
				],
				"brands": []
			}
		]
	},
	"dialog": null,
	"errors": null
}

Örnek Hatalı İstek (400) Cevabı:

{
	"statusCode": 400,
	"error": "Bad Request",
	"message": "body must be object"
}

Ö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ı ↩