🚀 TCSI API

Turkey Customer Satisfaction Index verilerine programatik erişim

Ücretsiz REST API JSON Güvenli

🔑 API Anahtarı Başvurusu

TCSI API'sine erişim için ücretsiz başvuru yapın. Başvurunuz 24-48 saat içinde değerlendirilecektir.

Firma/Organizasyon Adı *

İletişim Kişisi *

E-posta Adresi *

Telefon

Website

Kullanım Amacı *

Proje Açıklaması *

Beklenen Günlük İstek Sayısı

API Kullanım Şartlarını kabul ediyorum *

📚 API Dokümantasyonu

Temel Bilgiler

Base URL: https://www.sektorlideri.com/wp-json/tcsi/v1/

Format: JSON

Authentication: API Key Required

Rate Limit: 1000 requests/day (default)

🔐 Kimlik Doğrulama

API'yi kullanmak için API anahtarınızı aşağıdaki yöntemlerden biriyle gönderebilirsiniz:

1. Header ile:

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

2. Query Parameter ile:

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

📋 API Endpoint'leri

GET /firm/{id}

Belirli bir firmanın TCSI verilerini getirir

Örnek:

https://www.sektorlideri.com/wp-json/tcsi/v1/firm/123

GET /firms

Çoklu firma TCSI verilerini getirir

Parametreler:

ids - Firma ID'leri (virgülle ayırın)
limit - Kayıt sayısı (max: 100)
order_by - Sıralama (score, name)

Örnek:

https://www.sektorlideri.com/wp-json/tcsi/v1/firms?limit=20&order_by=score

GET /test

API anahtarınızın geçerliliğini test eder

Örnek:

https://www.sektorlideri.com/wp-json/tcsi/v1/test

📄 Yanıt Formatı

API yanıtları JSON formatında döner:

{
  "firm_id": 123,
  "name": "Örnek Firma",
  "city": "İstanbul",
  "tcsi": {
    "score": 87.5,
    "total_responses": 42,
    "certification_level": "gold",
    "score_category": "very_good"
  }
}

📋 Kullanım Şartları

API'yi yasal ve etik amaçlarla kullanın
Günlük istek limitlerini aşmayın
Verileri kullanırken TCSI kaynağını belirtin
Ticari projeler için önceden onay alın
API'yi kötüye kullanım durumunda erişim engellenebilir