COREC.ai

API Dokümantasyonu

COREC API ile müşteri yorumlarınızı analiz edin, duygu analizi yapın ve otomatik yanıt şablonları oluşturun.

Base URL

https://corec.ai

Kimlik Doğrulama

Tüm API istekleri Bearer token ile doğrulanmalıdır. Token'inizi dashboard'dan alabilirsiniz.

Header
Authorization: Bearer YOUR_API_TOKEN
POST /analyze

Müşteri yorumunu analiz eder. Özet, anahtar kelimeler, konu başlıkları, duygu analizi, kanaat puanı ve uygun e-posta şablonunu döndürür.

Request

Headers 
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
Request Body 
{
  "comment": "Siparis cok gec geldi, neredeyse 2 saat bekledik.",
  "date": "2024-01-15",
  "external_data": {
    "external_id": "IST-001",
    "external_label": "Kadikoy Subesi",
    "external_metadata": {
      "order_id": "ORD-12345",
      "customer_id": "C-789"
    }
  }
}

Parametreler

Alan Tip Zorunlu Açıklama
comment string Evet Müşteri yorumu (max 5000 karakter)
date string Evet Sipariş tarihi (YYYY-MM-DD)
external_data object Hayır Şube/lokasyon bilgileri
external_id string Hayır Şube/lokasyon ID'si (max 100 karakter)
external_label string Hayır Şube/lokasyon adı (max 255 karakter)
external_metadata object Hayır Ek veriler (serbest JSON formatı)

external_data Davranışı

  • • external_id hesabınız için benzersiz (unique) olarak saklanır.
  • • Aynı external_id tekrar gönderildiğinde yeni kayıt oluşturulmaz, mevcut lokasyon kullanılır.
  • • external_label değiştiğinde otomatik olarak güncellenir.
  • • Dashboard'da lokasyon bazlı filtreleme ve istatistikler için kullanılır.

Response (200 OK)

Response Body 
{
  "type": "success",
  "summary": "Musteri siparisinin gec ulastigindan sikayet ediyor.",
  "keywords": "gec teslimat, bekleme",
  "topics": "Gec Teslimat",
  "sentiment": "Negative",
  "predict": "-2",
  "email": {
    "template_name": "SERVIS SURESI MUSTERI MAIL",
    "template_content": "Degerli Musterimiz, ..."
  },
  "comment_id": 12345
}

Response Alanları

Alan Tip Açıklama
type string "success" veya "error"
summary string Yorumun kısa özeti
keywords string Anahtar kelimeler
topics string Konu başlıkları (virgül ile ayrılmış)
sentiment string "Positive", "Neutral" veya "Negative"
predict string Kanaat puanı (-3 ile +3 arası)
email object template_name ve template_content içeren obje
comment_id integer Kaydedilen yorumun ID'si

Hata Kodları

Kod Anlam Açıklama
401 Unauthorized Geçersiz veya eksik API token
422 Validation Error Eksik veya hatalı parametreler
500 Server Error Sunucu hatası

cURL Örneği

Terminal 
curl -X POST https://corec.ai/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "comment": "Siparis cok gec geldi",
    "date": "2024-01-15",
    "external_data": {
      "external_id": "IST-001",
      "external_label": "Kadikoy Subesi"
    }
  }'