REST API v1 Dokümantasyonu
Tüm uç noktalar https://www.sikayet.tc altında çalışır.
Kimlik doğrulama X-API-Key başlığıyla yapılır; anahtarınızı Marka Paneli → API Anahtarları
sayfasından oluşturabilirsiniz. Makine tarafından okunabilir şartname: /api/openapi.json (OpenAPI 3.0).
curl -H "X-API-Key: ANAHTARINIZ" "https://www.sikayet.tc/api/v1/markalar"
Anahtarınızı girin, sistem POST /api/test ucuyla kimliği doğrular ve örnek bir okuma yanıtı döner. Anahtar hiçbir yerde saklanmaz — yalnızca bu istekte kullanılır.
Marka panelinizden teknik ekip gerektirmeden bağlanabileceğiniz paketlenmiş senaryolar — markanızın olayları hedef uygulamalara otomatik düşer.
Yeni şikayet, generic CRM web kancasına ticket olarak iletilir (HubSpot/Bitrix/özel CRM uyumlu).
BağlaYeni şikayetler HubSpot ticket olarak açılır; hubspot_ticket_pipeline bağlantı yapılandırmasına girilir (alan eşlemesi hazır).
BağlaŞikayetler Zoho Desk ticket olur; orgId + departmentId bağlantı yapılandırmasına girilir.
BağlaŞikayetler Pipedrive aktivitesi olur; api_token + deal_id bağlantı yapılandırmasına girilir.
BağlaYeni şikayetler Discord sunucunuzdaki kanala web kancasıyla gelir.
BağlaYeni şikayet ve marka yanıtları Telegram botunuza mesaj olur. chat_id alanını bağlantı yapılandırmasına girin.
BağlaPlatform olaylarının tamamını Zapier'e iletir; orada binlerce uygulama ile zincirlenebilir.
Bağla| Metot | Adres | Açıklama | Parametreler |
|---|---|---|---|
| GET | /api/v1/markalar | Onaylı markaların listesi (skorlar dahil, en fazla 500 kayıt) | |
| GET | /api/v1/marka/{slug} | Tek markanın detayı + aylık metrikleri | |
| GET | /api/v1/sikayetler | Şikayet listesi (sayfalı) | sayfa=2&adet=20&marka=slug&kategori=slug |
| GET | /api/v1/sikayet/{id} | Tek şikayetin kamu görünümü | |
| GET | /api/v1/kategoriler | Aktif kategoriler | |
| GET | /api/v1/istatistik | Platform geneli toplam istatistikler | |
| GET | /api/v1/gundem | 24 saatlik yükselen konular (nabiz) | |
| GET | /api/v1/olaylar | Anonim olay akışı (kümelenmiş dosyalar) | |
| GET | /api/v1/endeks | Aylık sektör endeksi | |
| POST | /api/test | Canlı test isteği — anahtar kimliğini ve örnek yanıtı döner (M-4 portal konsolu) | |
| POST | /api/crm/{brandId}/{key} | Marka CRM girişi (marka panelinden alınan özel anahtar) | gövde: {"ref":"CV-123","status":"...","note":"..."} |
| GET | /api/app-config | Mobil uygulama uzak yapılandırması (anahtar gerektirmez) | |
| POST | /api/device/register | FCM cihaz token kaydı (oturum zorunlu, CSRF hariç) | gövde: {"token":"fcm-token","platform":"android"} |
webhook_teslim cron göreviyle kuyruktan yeniden denemeli gönderilir.