Sektör Lideri API Sistemi Yayınlandı

Türkiye’nin önde gelen müşteri memnuniyeti platformu Sektör Lideri, artık geliştiriciler için güçlü bir API hizmeti sunuyor! TCSI (Turkey Customer Satisfaction Index) verilerine programatik erişim sağlayan bu API ile uygulamalarınızı bir üst seviyeye taşıyabilirsiniz.

API Bağlantısı için Sektör Lideri API sayfasına giriş yapabilirsiniz. API erişimi için API Başvurusu sayfasından başvuru yapabilirsiniz.

API’nin Sunduğu Olanaklar

Sektör Lideri API, Türkiye’deki firmaların müşteri memnuniyeti verilerine kapsamlı erişim imkanı sunuyor. Bu API ile:

• Belirli firmaların TCSI skorlarını sorgulayabilir
• Şehir ve sektör bazlı en iyi firmaları listeleyebilir
• Çoklu firma verilerini toplu olarak alabilir
• Gerçek zamanlı müşteri memnuniyeti istatistiklerine erişebilirsiniz

API Kimlik Doğrulama Yöntemleri

API’yi kullanmaya başlamadan önce API anahtarınızı almanız gerekiyor. Kimlik doğrulama için üç farklı yöntem kullanabilirsiniz:

1. X-API-Key Header ile

curl -H "X-API-Key: your_api_key" \
https://www.sektorlideri.com/api/tcsi/v1/firm/123

2. Authorization Bearer ile

curl -H "Authorization: Bearer your_api_key" \
https://www.sektorlideri.com/api/tcsi/v1/firm/123

3. Query Parameter ile

curl "https://www.sektorlideri.com/api/tcsi/v1/firm/123?api_key=your_api_key"

Temel API Endpoint’leri

Tekil Firma Sorgulama

Belirli bir firmanın TCSI verilerini almak için:

GET /api/tcsi/v1/firm/{id}
GET /api/tcsi/v1/firm/{slug}

Çoklu Firma Sorgulama

Birden fazla firmanın verilerini pagination desteği ile almak için:

GET /api/tcsi/v1/firms?limit=20&order_by=score&order=DESC

Desteklenen parametreler:

• ids: Firma ID’leri (virgülle ayırın)
• limit: Sayfa başına kayıt (varsayılan: 10, max: 100)
• offset: Sayfa offset (varsayılan: 0)
• order_by: Sıralama kriteri (score, name, responses, updated)
• order: Sıralama yönü (ASC, DESC)

Şehir Bazlı En İyi Firmalar

GET /api/tcsi/v1/city/{city_name}/top?limit=10

Sektör Bazlı En İyi Firmalar

GET /api/tcsi/v1/sector/{sector_name}/top?limit=10

API Testi ve İstatistikler

GET /api/tcsi/v1/test        # API anahtar geçerliliği testi
GET /api/tcsi/v1/stats       # Genel TCSI istatistikleri

API Yanıt Formatı

API, JSON formatında zengin veri yapısı döndürür. Örnek bir firma yanıtı:

{
  "firm_id": 123,
  "name": "Örnek Firma A.Ş.",
  "slug": "ornek-firma-as",
  "city": "İstanbul",
  "address": "Örnek Mahallesi, Örnek Sokak No:1",
  "phone": "+90 212 123 45 67",
  "website": "https://www.ornekfirma.com",
  "category": "Restoran",
  "types": ["restaurant", "food"],
  "tcsi": {
    "score": 87.5,
    "total_responses": 42,
    "certification_level": "gold",
    "certification_label": "Altın",
    "score_category": "very_good",
    "last_updated": "2024-01-15 14:30:00",
    "tcsi_url": "https://www.sektorlideri.com/acsi/123/",
    "survey_url": "https://www.sektorlideri.com/acsi-anket/firma/123/ornek-firma/"
  },
  "location": {
    "latitude": 41.0082,
    "longitude": 28.9784,
    "place_id": "ChIJexample123"
  },
  "urls": {
    "profile": "https://www.sektorlideri.com/firma/123/ornek-firma/",
    "api": "/api/tcsi/v1/firm/123"
  },
  "meta": {
    "created_at": "2024-01-01 00:00:00",
    "updated_at": "2024-01-15 14:30:00",
    "is_active": true
  }
}

Programlama Dili Örnekleri

JavaScript (Frontend)

fetch('https://www.sektorlideri.com/api/tcsi/v1/firm/123', {
  headers: {'X-API-Key': 'your_api_key'}
})
.then(response => response.json())
.then(data => {
  console.log(`${data.name}: ${data.tcsi.score} TCSI`);
  console.log(`Madalya: ${data.tcsi.certification_label}`);
});

PHP (WordPress)

$response = wp_remote_get('https://www.sektorlideri.com/api/tcsi/v1/city/istanbul/top?limit=5', [
  'headers' => ['X-API-Key' => 'your_api_key']
]);

$data = json_decode(wp_remote_retrieve_body($response), true);

foreach ($data['data'] as $firm) {
  echo "{$firm['name']}: {$firm['tcsi']['score']} TCSI\n";
}

Python

import requests

headers = {'X-API-Key': 'your_api_key'}
response = requests.get('https://www.sektorlideri.com/api/tcsi/v1/firms?limit=10', 
                       headers=headers)

if response.status_code == 200:
  data = response.json()
  for firm in data['data']:
    print(f"{firm['name']}: {firm['tcsi']['score']} TCSI")

Kullanım Senaryoları

E-ticaret Siteleri

Ürün sayfalarında satıcı firmaların TCSI skorlarını göstererek müşteri güvenini artırabilirsiniz.

Mobil Uygulamalar

Konum tabanlı hizmetlerde yakındaki en yüksek TCSI skorlu firmaları listeleyebilirsiniz.

İş Zekası Uygulamaları

Sektörel analiz ve raporlama için kapsamlı müşteri memnuniyeti verilerini kullanabilirsiniz.

Web Siteleri ve Bloglar

İçerik sayfalarınızda firmaların güvenilirlik göstergelerini dinamik olarak gösterebilirsiniz.

API’yi Kullanmaya Başlayın

Sektör Lideri API’sini kullanmaya başlamak için API anahtarınızı almanız yeterli. Bu güçlü API ile Türkiye’nin en kapsamlı müşteri memnuniyeti veritabanına erişim sağlayarak uygulamalarınızı zenginleştirin.

Not: API kullanımı için öncelikle platforma kayıt olmanız ve API anahtarı almanız gerekmektedir. Detaylı dokümantasyon ve API anahtarı için Sektör Lideri web sitesini ziyaret edebilirsiniz.