API Dökümanı

Base URL'ler

Productionhttps://defacto.qsup.ai/api/v1

Sandboxhttps://defacto.qsup.ai/sandbox/api/v1

Kimlik Doğrulama

Tüm istekler Authorization header'ında Bearer token gerektirir.

Authorization: Bearer <API_KEY>
Content-Type: application/json

API anahtarı eksik veya geçersizse, endpoint 401 Unauthorized döner.

Endpoint

POST/suggest

"Bunu mu demek istediniz?" popup'ında gösterilecek içerik önerilerinden oluşan bir dizi döner. Öneri bulunamazsa dizi boş olacaktır.

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
`request_type`	string	Evet	Formda seçilen talep türü.
`detail`	string	Evet	Formda seçilen detay.
`message`	string	Evet	Müşterinin serbest metin mesajı.

Örnek İstek

POST /api/v1/suggest HTTP/1.1
Host: defacto.qsup.ai
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "request_type": "ONLINE ALIŞVERİŞ",
  "detail": "İADE EDİLEN ÜRÜNLER",
  "message": "Siparişim ne zaman teslim edilir?"
}

Yanıt

Öneri Bulundu

İlgili SSS eşleşmeleri bulunduğunda:

{
  "content": [
    {
      "title": "Teslimat Süresi",
      "content": "Siparişiniz kargoya verildikten sonra ortalama 1-3 iş günü içerisinde teslim edilir."
    }
  ]
}

Öneri Bulunamadı

Uygun SSS eşleşmesi olmadığında:

{
  "content": []
}

Yanıt Alanları

Alan	Tip	Açıklama
`content`	array	Öneri nesnelerinden oluşan dizi
`content[].title`	string	SSS başlığı (örn. "Teslimat Süresi")
`content[].content`	string	Popup'ta gösterilecek cevap metni

Hata Yanıtları

400 Bad Request

Geçersiz istek gövdesi (eksik zorunlu alanlar, geçersiz JSON vb.)

{
  "error": "invalid_request",
  "message": "'message' field is required and cannot be empty."
}

401 Unauthorized

Eksik veya geçersiz API anahtarı.

{
  "error": "unauthorized",
  "message": "Invalid or missing API key."
}

500 Internal Server Error

Genel sunucu hatası.

{
  "error": "server_error",
  "message": "An unexpected error occurred. Please try again later."
}