API’ye Genel Bakış

Bu sayfa Selwise'in geliştiricilere açık HTTP uçlarının dizinidir; widget'ın açılışta çektiği yapılandırma uçları Açılış Uçları sayfasındadır. Her ailenin ayrıntısı (parametre tabloları, curl örnekleri, gerçek yanıtlar, hata durumları) kendi sayfasındadır. Widget'ı kullanıyorsanız bu uçları çağırmanız gerekmez; mobil uygulama, sunucu entegrasyonu veya kendi arayüzünüz (headless) için doğrudan çağırırsınız.

Önce Kimlik Doğrulama ve Erişim sayfasını okuyun: hangi uca hangi kimlikle gideceğinizi orası anlatır.

Sözleşme

• Taban adres: https://api.selwise.com/api/v1
• Makine-okur sözleşme: Bu dizinin tamamı OpenAPI biçiminde https://selwise.com/openapi.public.json adresinde yayımlanır (/openapi.json aynı dosyadır). Her uç x-selwise-tier taşır: integration kararlı entegrasyon sözleşmesidir, widget ise widget ve SDK trafiğidir ve istemci protokolüyle birlikte evrilir. Her ucun kimlik türü x-selwise-auth, gereken anahtar kapsamı x-selwise-scope alanındadır. Panelin kendi API'si ve /channels/** yayımlanmaz. Kod üreten araçlara ve yapay zekâ destekli geliştirici asistanlarına bu dosyayı verebilirsiniz.
• Biçim: İstek ve yanıt gövdesi JSON'dur (Content-Type: application/json). Zaman damgaları, aksi yazılmadıkça ISO 8601 (yanıtlarda) ya da milisaniye cinsinden epoch (isteklerde eventTs, timestamp) biçimindedir.
• Bilinmeyen alan: Gövdesi sınıfla doğrulanan uçlar (events/batch, users/identify, users/traits, newsletter, contacts/consent, business-events, scenarios/inbox) tanımadığı bir alanı 400 ile reddeder; sessizce yok saymaz. orders, consent ve search/log, search/click, recommendations/track/* gövdeyi sınıfla doğrulamaz ve fazladan alanı yok sayar (tek istisna: orders gövdesinde id alanı 400 verir). Alan adlarını tam yazın. Ayrıntı: Hatalar ve Sınırlar.
• Durum kodu yetmez: events/batch, search/log ve benzeri analitik uçlar bilinmeyen site anahtarına bile 200 dönebilir; success alanına bakın.
• Hız sınırları uca göre değişir; bir uç özel bir sınır taşımıyorsa IP başına dakikada 100 istek geçerlidir ve sınır uç başına ayrı sayılır. Bkz. Hız sınırları.

Tarayıcıdan deneme

Uç sayfalarındaki her işlemin Dene sekmesi, isteği kendi kanal anahtarınızla bu sayfadan gönderir. Okuma uçları olduğu gibi çalışır; yazma uçları her zaman deneme çalıştırması (x-selwise-dry-run: 1) olarak gider: istek doğrulanır, yetki kontrol edilir ama hiçbir şey yazılmaz, olay ya da kuyruk işi oluşmaz. API anahtarınız yalnızca bu sekmenin belleğinde tutulur ve sayfayı kapattığınızda silinir. Kurallar: Yazmadan denemek.

Makine-okur sözleşmenin tamamı tek dosyadır: openapi.public.json. Postman, Insomnia ya da bir kod üreticiye doğrudan verebilirsiniz.

Uç dizini

Kimlik sütunu: Alan = alan adı doğrulaması (veya anahtar, başlık yoksa), Anahtar = her zaman API anahtarı, Yok = yalnızca siteKey.

Açılış ve içerik

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
GET /public/sites/:siteKey/config	Alan	Kampanya, öneri, takip, arama, zenginleştirme, deney ve tema yapılandırmasının toplu yanıtı	Bu sayfa
GET /public/sites/:siteKey/tracking-config	Alan	Yalnızca takip yapılandırması	Bu sayfa
GET /public/sites/:siteKey/integrations	Alan	Veri katmanı, entegrasyon ve webhook ayarları	Bu sayfa
GET /public/sites/:siteKey/campaigns	Alan	Aktif kampanyalar	Bu sayfa
GET /public/sites/:siteKey/widgets	Alan	Kullanımdan kalktı, her zaman boş liste	Bu sayfa
GET /public/sites/:siteKey/scripts	Alan	Bir yola ait özel script'ler	Bu sayfa
GET /public/sites/:siteKey/product-metrics/view-count, .../cart-count, POST .../batch	Alan	Ürün rozeti sayıları	Bu sayfa

Ölçüm

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
POST /public/sites/:siteKey/events/batch	Yok	Olay toplu gönderimi	Olay Gönderimi
POST /public/sites/:siteKey/metrics	Yok	İstemci sağlık sayaçları	Olay Gönderimi
POST /public/sites/:siteKey/orders	Alan	Sipariş	Sipariş API'si
POST /public/sites/:siteKey/users/identify, .../users/traits	Alan	Kullanıcı kimliklendirme	Kullanıcı Kimliklendirme API'si
POST /public/sites/:siteKey/business-events	Alan	Kendi sisteminizin olayı (senaryo tetikler)	İş Olayları

Arama ve öneri

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
GET /public/sites/:siteKey/search, .../search-config, .../search/suggestions	Alan	Arama, yapılandırma, öneri listesi	Arama API'si
POST /public/sites/:siteKey/search/log, .../search/click, .../search/zero-results	Yok	Arama analitiği	Arama API'si
GET /public/sites/:siteKey/recommendations, POST .../recommendations/:widgetId/products	Alan	Öneri şeritleri ve ürünleri	Öneri API'si
POST /public/sites/:siteKey/recommendations/track/event, .../track/behavior	Yok	Öneri analitiği	Öneri API'si

Zenginleştirme ve sunucu taraflı render

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
GET /public/sites/:siteKey/enrichments, .../product-facts	Alan	Ürüne ait blok içeriği, katalog gerçekleri	Zenginleştirme API'si
GET /public/sites/:siteKey/app/enrichments	Anahtar (uygulama kanalı)	Uygulama kanalı için hazır içerik	Zenginleştirme API'si
GET /public/sites/:siteKey/ssr/enrichments	Anahtar (ssr_read)	Sunucuda basılacak hazır HTML	Sunucu Taraflı Render API

İzin ve abonelik

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
POST ve DELETE /public/sites/:siteKey/consent	Alan	Çerez onayı kaydı ve geri çekme	Onay ve Bülten API'si
POST /public/sites/:siteKey/contacts/consent	Anahtar (newsletter_subscribe)	Pazarlama izni (kendi sunucunuzdan)	Onay ve Bülten API'si
POST /public/sites/:siteKey/newsletter	Alan	Bülten kaydı	Onay ve Bülten API'si

Katalog

Yöntem ve yol	Kimlik	Ne yapar	Sayfa
POST /public/feeds/:token	Token (yolda)	Ürün beslemesini gönderme	Besleme Gönderme

Widget'ın iç uçları

Deney ataması, segment değerlendirme, senaryo gelen kutusu, tarayıcı bildirim aboneliği, e-posta abonelikten çıkış bağlantıları ve görsel editör widget'ın kendi trafiğidir; sözleşmeleri Widget'ın Kendi Kullandığı Uçlar sayfasındadır.

Açılış: config

Widget'ın açılışta çektiği config, tracking-config, integrations, campaigns, scripts ve product-metrics uçları ayrı sayfada: Açılış Uçları.

Headless örüntü

Mobil ya da sunucu entegrasyonunda tipik akış:

1. Açılışta config çekilir (başlıksız istek ve x-selwise-api-key).
2. Etkileşim oldukça events/batch gönderilir.
3. Satın almada orders gönderilir.
4. Giriş yapıldığında users/identify çağrılır.

Mobil uygulama için hazır SDK'yı kullanmak bu akışı sizin yerinize yürütür: Mobil SDK.