# Kısa cevap: Twitch Helix'e göre ne değişiyor
Kick'in genel API'si, her authorization code değişiminde PKCE ile OAuth 2.1 kullanır — evet, gizli sunucu istemcileri için bile. OAuth host'u: id.kick.com. Açık konuşalım — kaynak API host'u: api.kick.com/public/v1. Access token'lar varsayılan olarak 3600 saniye sonra sona erer. Refresh token'lar her değişimde döner. Nisan 2026 itibarıyla push teslimat yalnızca webhook'larla yapılır. Twitch Helix'ten mi geçiyorsun? Önce üç değişiklik canını yakar: PKCE zorunlu, refresh rotasyonu katı, scope adları Twitch'ten çok GitHub'a yakın. (Platformda yeni misin? Önce 2026'da Kick nedir yazımıza göz at, sonra entegrasyon mekaniği için buraya dön.)
- OAuth host'u: id.kick.com (kaynak host'undan ayrı)
- Kaynak host'u: api.kick.com/public/v1
- Desteklenen grant'ler: authorization_code (PKCE ile), refresh_token, client_credentials
- PKCE: code_challenge_method S256 olmalıdır. Plain reddedilir
- Push teslimat: yalnızca webhook'lar. WebSocket aktarımı yol haritasında
- Token endpoint'leri: /oauth/authorize, /oauth/token, /oauth/revoke, /oauth/token/introspect
# PKCE, Kick'te neden isteğe bağlı değil
Kick'te PKCE bir tavsiye değildir. Yetkilendirme sunucusu, code_challenge içermeyen her /oauth/authorize isteğini reddeder — istemci ayrıca secret sunsa bile. Bu, OAuth 2.1'in daha geniş konsolidasyonunu yansıtır. oauth.net'teki OAuth 2.1 spesifikasyon sayfasına göre: "PKCE is required for all OAuth clients using the authorization code flow" (PKCE, authorization code akışını kullanan tüm OAuth istemcileri için zorunludur). Aynı sayfa "the Implicit grant (response_type=token) is omitted from this specification" ve "the Resource Owner Password Credentials grant is omitted from this specification" ifadelerini de içerir — eski Twitch eğitimlerinin hâlâ andığı iki akış.
RFC 7636 Bölüm 1.1 koruma mekanizmasını açıklar: "An attacker who intercepts the authorization code at (B) is unable to redeem it for an access token, as they aren't in possession of the 'code_verifier' secret." Spesifikasyon dilinden çevirisi: client_secret'in bir log dosyasından veya yanlış yapılandırılmış bir CDN'den sızsa bile, bir yönlendirme URL'sinden authorization code çalan saldırgan, sunucu tarafında sakladığın verifier olmadan token değişimini tamamlayamaz. code_challenge_method'u S256'ya sabitle: RFC 7636 §4.2, bunu hesaplayabilen her istemciden ister — plain yöntemi spesifikasyonda hâlâ serbesttir ama Kick pratikte onu reddeder. Kemer ve pantolon askısı.
Taşıma sırasında sık görülen bir gerileme: Twitch için yazılmış bir auth URL oluşturucu code_challenge eklemez ve id.kick.com invalid_request ile yanıt verir. Nedeni fark etmek, düzeltmekten uzun sürer. Twitch kod yollarını Kick'e yöneltmeden önce güncelle.
# Adım 1. Uygulamanı kaydet
Uygulamanın sahibi olacak hesapla oturum açıp kick.com/settings/developer adresini aç. Kick Yardım Merkezi'ndeki "KICK Dev" sayfası da aynı yolu tarif eder: "head to your account settings page and choose the 'developer' tab, then use the form to create an app and receive your Client ID and Client Secret." Yani hesap ayarlarına git, geliştirici sekmesini seç ve formla uygulamayı oluşturup Client ID ile Client Secret'ı al. Şunları doldur:
- Uygulama adı. Onay ekranında kullanıcılara gösterilir. Zaman içinde sabittir. Onaydan sonra yeniden adlandırmak canlı token'ları geçersiz kılmaz.
- Redirect URI'ler. OAuth callback'inin bulunduğu bir veya daha fazla birebir URI. Üretimde HTTPS zorunlu. Geliştirme için açık port belirtilmiş localhost'a izin verilir.
- Açıklama. Onay ekranında görünen bir veya iki cümle.
- Kategori. En yakın olanı seç. Bugün yalnızca bilgilendiricidir; Kick, ileride kategoriye göre limit uygulama hakkını saklı tutar.
Kaydedince bir client_id (herkese açık, front-end paketlerine gömmek güvenli) ve bir client_secret (yalnızca sunucu tarafı) alırsın. Kısa not — secret'ı bir veritabanı parolası gibi ele al. Kullanıcıları yalnızca PKCE ile doğrulayan herkese açık tek sayfalık uygulamalar secret olmadan çalışabilir. Sunucu tarafı istemciler her zaman ikisini de sunmalıdır.
En sinsi tuzak: redirect_uri uyuşmazlığı. Kick birebir dize karşılaştırması yapar. https://example.com/oauth/callback ile https://example.com/oauth/callback/ eşleşmez — sondaki eğik çizgi önemlidir. Büyük/küçük harf önemlidir. Portlar önemlidir. Alt alan adları önemlidir. Staging ve üretim URL'si bayt bayt eşleşmelidir. OAuth 2.1 spesifikasyonu bu katılığı destekler: "Redirect URIs must be compared using exact string matching." Ortam başına bir URI tut. Joker karakter numaralarından kaçın. Çalışmazlar.
# Adım 2. PKCE çiftini üret
Kullanıcıyı yönlendirmeden önce her oturum için yeni bir code_verifier ve code_challenge çifti oluştur. RFC 7636 Bölüm 4.1, verifier'ı kelimesi kelimesine tanımlar: "code_verifier = high-entropy cryptographic random STRING using the unreserved characters [A-Z] / [a-z] / [0-9] / "-" / "." / "_" / "~" from Section 2.3 of [RFC3986], with a minimum length of 43 characters and a maximum length of 128 characters." Challenge, Bölüm 4.2'ye göre türetilir: "S256: code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))". Kodda her biri tek satıra sığar.
Node.js'te referans uygulama (base64url'in Buffer'a yerleşik olduğu Node 18+ üzerinde çalışır):
const crypto = require('crypto'); const verifier = crypto.randomBytes(64).toString('base64url'); const challenge = crypto.createHash('sha256').update(verifier).digest('base64url');
Aynı çift Python'da:
import secrets, hashlib, base64; verifier = secrets.token_urlsafe(64); challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode('ascii')).digest()).rstrip(b'=').decode('ascii');
code_verifier'ın yönlendirmeden sağ çıkması, redirect_uri eşleşmesinden sonraki ikinci en sinsi tuzaktır. Onu, yönlendirme işleyicisinin token değişimi sırasında alabileceği bir yerde sakla. Çok örnekli bir backend için en temiz seçenek, state parametresiyle anahtarlanan sunucu tarafı oturumdur. Şifreli çerez, durumsuz kurulumlarda işe yarar. localStorage SPA'larda işe yarar. Verifier, id.kick.com'a gidiş-dönüşte hayatta kalmalıdır. Depolama katmanın onu düşürürse token değişimi invalid_grant ile başarısız olur ve kullanıcı baştan başlamak zorunda kalır. Klasik tuzak: bellek içi depo, çok örnekli backend, sticky session yok.
- Verifier'ı asla düz metin olarak loglama. Kısa ömürlü bir secret gibi ele al
- Her yetkilendirme denemesi için yeni bir verifier üret. Verifier'ları yeniden kullanmak PKCE'yi geçersiz kılar
- Yetkilendirme isteğinde code_challenge_method=S256 gönder. Plain yöntemi RFC 7636'da belgelenmiştir ama Kick onu reddeder
- Güvenli varsayılan olarak base64url ile kodlanmış 64 rastgele bayt (~86 karakter) kullan. 128 tavanına ulaşmadan 43 karakterlik asgariyi rahatça aşar
# Adım 3. Yetkilendirme isteğini oluştur
Kullanıcının tarayıcısını aşağıdaki parametrelerle https://id.kick.com/oauth/authorize adresine yönlendir. Kick'in geliştirici dokümantasyonu aynı kümeyi docs.kick.com'daki "Generating Tokens (OAuth 2.1 Flow)" sayfasında listeler; GitHub'da KickEngineering/KickDevDocs altında yansıtılmıştır. Auth URL oluşturucusunu tek bir yardımcı dosyada tut — böylece uç durumlar azalır.
- response_type=code. Authorization code akışı için her zaman code
- client_id. Developer Portal kaydından
- redirect_uri. Kayıtlı URI'lerinden biriyle birebir eşleşme
- scope. İhtiyacın olan scope'ların boşlukla ayrılmış listesi (aşağıdaki Scope'lar bölümüne bak)
- state. Değiştirilmeden geri yansıtılan opak değer. CSRF'yi önlemek ve verifier aramanı anahtarlamak için kullan
- code_challenge. 2. adımdaki PKCE challenge'ı
- code_challenge_method=S256
Tam bir URL şöyle görünür:
https://id.kick.com/oauth/authorize?response_type=code&client_id=YOUR_ID&redirect_uri=https%3A%2F%2Fapp.example.com%2Fauth%2Fcallback&scope=channel%3Aread+chat%3Awrite&state=abc123&code_challenge=CHALLENGE&code_challenge_method=S256
Kullanıcı Kick'in onay ekranını görür. Scope'ları inceler. Onaylar veya reddeder. Onaylarsa Kick, ?code=AUTH_CODE&state=abc123 ile URI'ne yönlendirir. Reddederse ?error=access_denied&state=abc123 alırsın. Başka bir şey yapmadan önce state'i doğrula. Bir referrer logundan veya sızdıran bir proxy'den code çalan saldırgan, onu callback'ine beslemeyi deneyebilir. State doğrulaması senin savunmandır. authorization_code grant'ini kullan, implicit'i değil. refresh_token rotasyonunu atlamak kendi sorumluluğundadır.
Belirtmeye değer bir geliştirme tuzağı. Açık konuşalım: Kick, yerel testler için 127.0.0.1 yönlendirme URI'lerine izin verir. Kısa not — geliştirme sunucun Next.js üzerinde çalışıyorsa, framework bazı durumlarda 127.0.0.1'i localhost'a yeniden yazar. KickEngineering dokümantasyonu bunu açıkça belirtir ve redirect_uri'den önce gelen feda edilebilir bir sorgu parametresi önerir veya doğrudan localhost kaydını önerir. localhost kaydetmek, daha az hareketli parça demektir.
# Adım 4. Kodu token'larla değiştir
Yönlendirme işleyicin authorization code'u alır ve form-urlencoded bir gövdeyle https://id.kick.com/oauth/token adresine POST etmelidir. Kodlar tek kullanımlık ve kısa ömürlüdür. Hemen değiştir. Sonraya saklama.
- grant_type=authorization_code
- code. Yönlendirmeden gelen authorization code
- redirect_uri. 3. adımda kullanılanla birebir eşleşme
- client_id. Kaydından
- client_secret. Yalnızca gizli istemciler için
- code_verifier. 2. adımda sakladığın PKCE verifier'ı
Content-Type'ı application/x-www-form-urlencoded olarak ayarla. 200 yanıtı; access_token, refresh_token, token_type (her zaman Bearer), expires_in (saniye, bir saat için tipik olarak 3600) ve scope (gerçekte verilen scope'ların boşlukla ayrılmış listesi — kullanıcı onay ekranında kutuların işaretini kaldırdıysa istediğinin bir alt kümesi olabilir) içeren JSON döndürür.
Başarılı yanıt örneği, gizlenmiş:
{ "access_token": "eyJhbGciOi...", "token_type": "Bearer", "refresh_token": "def456...", "expires_in": 3600, "scope": "user:read channel:read chat:write" }
Her iki token'ı da sunucu tarafında, diskte şifreli sakla. access_token kısa ömürlüdür (varsayılan olarak bir saat). İşte mesele şu — refresh_token uzun ömürlüdür ve kullanıldıkça döner. Herkese açık SPA'lar ikisini de doğrudan tutmamalı. Standart desen backend-for-frontend'dir — tarayıcı bir oturum çerezi tutar, sunucu ise API çağrılarını kullanıcının token'ı eklenmiş şekilde iletir.
api.kick.com/public/v1'e yapılan çağrılar access_token'ı Authorization başlığında kullanır: Authorization: Bearer eyJhbGciOi.... Açık konuşalım — Kick Dev dokümanlarındaki Endpoints kataloğu Users, Channels, Livestreams, Categories, Chat ve Moderation'ı kapsar. Twitch'in Helix üzerinden sunduğu yüzeyin aynısı, ince farklarla değişen istek biçimleriyle.
# Adım 5. Refresh token rotasyonu
Kick, her refresh değişiminde yeni bir refresh_token verir ve öncekini anında geçersiz kılar. Bu refresh token rotasyonudur — spesifikasyon notuna göre herkese açık istemciler için OAuth 2.1 varsayılanı: "Refresh tokens for public clients must either be sender-constrained or one-time use." Kick aynı kuralı gizli istemcilere de uygular. Yeni çift verildiği anda eski refresh token'lar çalışmaz. İstisna yok.
Keskin kenar: eşzamanlı refresh'ler. İki API çağrısı aynı anda tetiklenir. İkisi de süresi dolmuş bir access_token fark eder. İkisi de mevcut refresh_token'ı /oauth/token'a POST eder. Biri taze bir çift alır. Diğeri invalid_grant alır — çünkü ilk çağrı token'ı çoktan tüketmiştir. Kullanıcının gözünden entegrasyon onu rastgele oturumdan atıyor gibi görünür. Çözüm, kullanıcı başına serileştirmedir.
- access_token'ın hâlâ geçerli olup olmadığını kontrol et (expires_at > şimdi + 60 sn tampon)
- Geçerliyse API çağrısıyla devam et
- Değilse kullanıcı başına bir mutex al (Redis, Postgres advisory lock veya tek örnekse süreç içi)
- Aldıktan sonra yeniden kontrol et. Başka bir eşzamanlı istek zaten refresh etmiş olabilir
- Hâlâ eskiyse /oauth/token'a grant_type=refresh_token ile POST et, her iki token'ı depoda atomik olarak güncelle, mutex'i bırak
- Özgün API çağrısını yeni access_token ile yeniden dene
Refresh gövdesi kısadır. grant_type=refresh_token, refresh_token=<current>, client_id ve uygulamayı gizli olarak kaydettiysen client_secret. code_verifier yok. PKCE yalnızca authorization-code grant'ine aittir. Yanıt biçimi özgün token değişimiyle aynıdır. Başarı döndürmeden önce yeni refresh_token'ı kalıcı hâle getir. Yeni çifti alıp saklamak arasında çökersen kullanıcı dışarıda kalır ve yeniden yetkilendirmesi gerekir. Bu bloğu bir veritabanı işlemine sar.
# Mevcut scope'lar ve neleri açtıkları
Kick'in scope sözdizimi, Twitch'in noktalı stili yerine iki nokta üst üste kullanır. Liste, Twitch'in lansmandaki listesinden daha ayrıntılıdır. Yalnızca ihtiyacın olanı iste. Fazla istemek, onayın reddedilme oranını ölçülebilir biçimde artırır (sektör deseni, Kick'e özgü değil). İlk yetkilendirmeden sonraki scope değişiklikleri yeni onay gerektirir. Mevcut bir token'ı sessizce genişletemezsin.
- user:read. Yetkilendirilmiş kullanıcının profilini oku (id, kullanıcı adı, e-posta doğrulama durumu)
- channel:read. Kullanıcının kanal meta verilerini oku (ad, açıklama, kategori, takipçi sayısı)
- channel:write. Kanal meta verilerini güncelle (kategori, başlık, etiketler)
- chat:write. Yetkilendirilmiş kullanıcı adına veya bot olarak sohbet mesajı gönder
- chat:read. Sohbet olaylarına abone ol (çoğu akışta artık events:subscribe altında birleşti)
- streamkey:read. Yayın yapmak için kullanıcının yayın URL'sini ve yayın anahtarını oku
- events:subscribe. Sohbet, takip, abonelik ve canlı yayın durumu olayları için webhook abonelikleri oluştur
- moderation:ban. Kullanıcının moderatör olduğu bir kanalda yasak ve zaman aşımı uygula veya kaldır
- moderation:chat_message:manage. Sohbet mesajlarını sil
- channel:rewards:read. Kanal puanları ödüllerinin yapılandırmasını oku
- channel:rewards:write. Kanal puanları ödüllerini oluştur, güncelle veya sil
Entegrasyonun gelişirse kullanıcıdan güncellenmiş scope listesiyle yeniden yetkilendirmesini iste. Onay ekranı farkı gösterir. Tek oturumda birden fazla dar onayı zincirleme. Her ek ekranda dönüşüm düşer.
# Webhook abonelikleri ve olay türleri
Webhook'lar bugün Kick'teki tek push aktarımıdır. WebSocket tabanlı olaylar, KickEngineering/KickDevDocs'ta Issue #20 olarak herkese açık yol haritasında yer alır ama Nisan 2026 itibarıyla yayında değildir. Abone olmak için access token'ının events:subscribe taşıması gerekir. Hesabın, geliştirici ayarlarında yapılandırılmış herkese açık bir webhook URL'sine sahip olması gerekir.
Abonelikler şu adreste yaşar: https://api.kick.com/public/v1/events/subscriptions. Oluşturmak için POST, listelemek için GET, kaldırmak için DELETE. Belgelenmiş olay türleri şunları içerir:
- chat.message.sent. Abone olduğun bir kanalda sohbet mesajı gönderilir
- channel.followed. Bir izleyici kanalı takip eder
- channel.subscription.new. Yeni bir ücretli abonelik başlar
- channel.subscription.renewal. Mevcut bir abonelik yenilenir
- channel.subscription.gifts. Bir veya daha fazla hediye abonelik gönderilir
- livestream.status.updated. Bir yayın canlıya geçer veya kapanır
- livestream.metadata. Başlık, kategori veya etiketler yayın sırasında değişir
- kicks.gifted. Kick'ler (platformun bahşiş para birimi) hediye edilir
- moderation.banned. Bir izleyici yasaklanır veya zaman aşımına uğratılır
Gelen webhook isteklerinde HMAC imzasını doğrula. Kick, payload'ları uygulamanın signing secret'ı ile imzalar ve imzayı bir başlığa koyar. Doğrulama fonksiyonu, Stripe veya GitHub webhook'larında uygulayacağınla birebir aynıdır. Kontrolü atlamak bir optimizasyon değil, güvenlik hatasıdır.
Teslimat semantiği önemlidir. Kick dokümanları şunu belirtir: "Kick will retry sending the webhook 3 times, until 200 response is made by your server. If your server is unreachable or non-OK response is returned, Kick automatically unsubscribe the event." Yani Kick 3 kez yeniden dener; sunucun erişilemezse veya hata yanıtı dönerse olay aboneliğini otomatik iptal eder. Hızlı biçimde 2xx döndür — birkaç saniye içinde — ve payload'ı eşzamansız işle. Bir kuyruğa at, hemen onayla ve ağır işi aşağı akıştaki worker'lara bırak. Ara sıra zaman aşımına uğrayan yavaş bir işleyicinin aboneliği kaldırılır ve eksik olduğunu bilmediğin olayları kaybedersin.
# İstek limitleri ve backoff stratejisi
İstek limiti sayıları, Nisan 2026 itibarıyla Kick API yüzeyinin en az belgelenmiş kısmıdır. Platform, saniye cinsinden bir Retry-After başlığıyla 429 Too Many Requests döndürür. @nekiro/kick-api gibi topluluk kütüphaneleri, retryAfter özelliğine sahip bir KickRateLimitError sunar. Kesin sayılar — client_id başına tavan, kullanıcı token'ı başına tavan — resmî olarak yayımlanmamıştır. Kick bunları belgeleyene veya entegrasyonun deneysel veri üretene kadar temkinli bütçele.
Yaygın hata türü: fan-out. Bir cron, 50 kullanıcı kanalını paralel dolaşır. Her biri bir refresh ve üç okuma başlatır. Toplam, hiçbir tekil kullanıcı yoğun olmasa bile istemci başına limiti aşar. Çözüm, Twitch Helix'e karşı kullanılan reçetenin aynısıdır — hem client_id düzeyinde hem de kullanıcı başına token-bucket ile sınırlama.
- Retry-After'a her zaman uy. 429 aldıktan sonra başlık dolmadan yeniden deneme
- Sınırlama katmanları olarak client_id başına ve user_id başına bir token bucket kullan
- Yüksek hacimli kullanımda polling yerine webhook'u tercih et. Takipçi sayısını veya sohbet geçmişini sorgulamak yerine channel.followed ve chat.message.sent'e abone ol
- Salt okunur meta verileri (kanal meta verileri, takipçi sayıları, kategori bilgisi) 30 ila 60 saniyelik kısa TTL'lerle önbelleğe al
- 429 aldığında Retry-After değerini ve endpoint'i logla. Desen, hangi yüzeyin trafik profiline göre yetersiz boyutlandırıldığını ortaya koyar
# Yaygın hatalar ve nasıl ayıklanır
Karşılaşma olasılığı en yüksek hatalar:
- Token değişiminde invalid_grant. code_verifier, code_challenge ile eşleşmiyor, kod zaten kullanılmış (tek kullanımlık) veya redirect_uri 3. adımda kullanılanla eşleşmiyor. Önce PKCE depolama katmanını incele. Gerilemelerin çoğu orada saklanır.
- invalid_client. client_id yanlış, client_secret yanlış veya secret'ı olmayan herkese açık bir uygulama için client_secret gönderilmiş. Developer Portal değerlerini doğrula. Uygulamanın gizli mi herkese açık mı kaydedildiğini teyit et.
- invalid_request. Zorunlu bir parametre eksik. Genellikle yetkilendirme isteğinde state, code_challenge veya code_challenge_method.
- unauthorized_client. Uygulamanın kayıtlı grant türleri authorization_code içermiyor. Developer Portal'daki grants sekmesini kontrol et.
- invalid_scope. Var olmayan veya daha yüksek bir uygulama katmanı gerektiren bir scope istedin. Kick'in deneysel scope'ları ara sıra yeniden adlandırılır. Güncel dokümanla doğrula.
- access_denied. Kullanıcı onayı reddetti. Logla ve devam et. Hata değil.
- expired_token. access_token'ının süresi doldu. Refresh et ve yeniden dene.
- Refresh'te invalid_grant. Eski, zaten döndürülmüş bir refresh_token gönderdin. Serileştirmeyi unuttuğun eşzamanlı bir refresh ara.
Hata ayıklama ilkesi: Kick'in hata yanıtları OAuth standardındadır ve yararlıdır, ancak istek gövdesini ve yanıt gövdesini sunucu tarafında loglamak (code, code_verifier ve token'lar gizlenmiş şekilde) aralıklı sorunlarda saatler kazandırır. Çok kullanıcılı hata ayıklamanın her seferinde tek oturumla sınırlı kalması için logları her zaman state parametresiyle ilişkilendir.
# Twitch Helix OAuth'undan farklar
Twitch Helix'ten mi geçiyorsun? Kavramsal model aynı — refresh token'lı authorization code akışı, scope korumalı REST endpoint'leri, imzalı webhook'lar. Mekanik, sağlayıcı başına yapılandırma gerektirecek kadar ayrışır. Daha geniş platform karşılaştırmasını Kick vs Twitch 2026 yazımızda açtık. API katmanındaki farklar şöyle:
- Kick'te PKCE her istemci türü için zorunludur. Twitch, gizli istemciler için isteğe bağlı tutar
- Kick, refresh token'ları her değişimde döndürür. Twitch refresh token'ları iptal edilene kadar yeniden kullanılabilir
- Kick scope adları iki nokta üst üste kullanır (channel:read). Twitch noktalı yollar kullanır (user:read:email)
- Kick'in yetkilendirme endpoint'i id.kick.com. Twitch'inki id.twitch.tv
- Kick'in kaynak API tabanı api.kick.com/public/v1. Twitch'inki api.twitch.tv/helix
- Kick ID token vermez (saf OAuth 2.0 authorization code, OIDC yok). Twitch, OpenID claim'leri için OIDC etkin akışları destekler
- Kick yalnızca webhook sunar. Twitch EventSub, webhook callback'lerine ek olarak WebSocket aktarımını destekler
- Webhook imza doğrulaması farklıdır. Kick, ham gövde üzerinde HMAC kullanır. Twitch EventSub, HMAC'i bir challenge-response el sıkışmasıyla birleştirir
Twitch için yapılandırılmış ortak bir OAuth kütüphanesi makul bir başlangıç noktasıdır. PKCE zorunluluğu ve refresh rotasyonu semantiği için sağlayıcı başına ayarlama gerekir. Node.js'te openid-client, Kick'e özgü bir istemci yapılandırması ve açık bir refresh serileştirme ara katmanıyla çalışır. Aynı kütüphane, farklı yapılandırmayla aynı kod tabanında Twitch ile de konuşabilir. Python mu kullanıyorsun? kickcom.py ve authlib, PKCE biçimini kutudan çıktığı gibi doğru işler.
Belirtmekte fayda var: Kick, programlanabilir bir yüzey olarak Twitch'ten daha gençtir. Platform genel API'sini 2024'te 100 bin dolarlık bir geliştirici ödül programıyla başlattı. Dokümanlar github.com/KickEngineering/KickDevDocs üzerinde gerçek zamanlı gelişiyor. Bağımlılıklarını sabitle. Changelog'u izle. Deneysel endpoint'lerde ara sıra şema ince ayarları bekle. OAuth çekirdeği 2025 boyunca ve 2026'ya kadar kararlı kaldı. Moderasyon ve kanal puanları endpoint'leri daha çok değişti. Entegrasyonun içerik üreticisi gelir elde etme meta verilerine dokunuyorsa, Kick gelir elde etme yolu (Creator, Verification, Partner) dökümümüz her katmanın API üzerinden nelere erişim sağladığını anlatır.
# SSS
Kick'te implicit grant veya parola grant'ini kullanabilir miyim?
Hayır. OAuth 2.1 ikisini de kullanımdan kaldırır. Kick; authorization_code (PKCE ile), refresh_token ve yalnızca uygulama endpoint'leri için client_credentials destekler. oauth.net'teki OAuth 2.1 spesifikasyon sayfası bunu açıkça söyler: "the Implicit grant is omitted from this specification" ve "the Resource Owner Password Credentials grant is omitted from this specification."
client_secret'im varsa PKCE gerekir mi?
Evet. Kick'in yetkilendirme sunucusu, client_secret verilse bile code_challenge ve code_challenge_method içermeyen authorization-code isteklerini reddeder. PKCE, OAuth 2.1'de istemcinin gizliliğinden bağımsız olarak evrensel hâle geldi.
Access token ve refresh token'lar ne kadar geçerlidir?
Access token'lar, token yanıtında bir expires_in değeri taşır; tipik olarak 3600 saniye (bir saat). Refresh token'lar daha uzun sürer ve her değişimde döner. Spesifikasyon, refresh token son kullanma süresini istemciye bilerek iletmez. Onları uzun ömürlü say ama başarısız olduklarında her zaman yeniden yetkilendirme yedeği bulundur.
Kaynak endpoint'leri için API temel URL'si nedir?
https://api.kick.com/public/v1. Çağrılar access_token'ı bir Authorization: Bearer başlığında kullanır. Users, Channels, Livestreams, Categories, Chat ve Moderation endpoint'lerinin tümü bu önek altındadır. OAuth host'u (id.kick.com) bilerek kaynak host'undan ayrılmıştır.
Sohbet veya takip olaylarına nasıl abone olurum?
events:subscribe scope'unu iste, Developer Portal ayarlarında herkese açık bir webhook URL'si yapılandır ve olay adı (chat.message.sent, channel.followed vb.) ile dinlemek istediğin broadcaster_user_id'yi https://api.kick.com/public/v1/events/subscriptions adresine POST et. Gelen payload'ların HMAC imzasını doğrula. Her zaman.
Refresh'im neden ara sıra invalid_grant döndürüyor?
Eşzamanlı refresh'ler. Kick, refresh_token'ı kullanıldığında döndürür; bu yüzden iki paralel refresh denemesi yarışır ve biri yeni geçersiz kılınmış bir token gönderir. Refresh değişimlerini kullanıcı başına bir mutex ile serileştir (Redis, Postgres advisory lock veya tek örnekli backend'ler için süreç içi). Eşzamanlı API çağrılarını, yeniden denemeden önce süren refresh'in bitmesini bekletecek şekilde kur.
Akışı geliştirme ortamında test etmenin en iyi yolu nedir?
localhost veya 127.0.0.1 yönlendirme URI'leri ve yalnızca geliştirmeye özel bir client_id ile geliştirmeye özel bir uygulama kaydet. Postman'in OAuth 2.1 yardımcısı PKCE'yi doğru destekler. Geliştirme testleri için üretim client_id'sini asla yeniden kullanma. Kick'in istek limitleri ve scope onayları istemci başınadır. Gürültülü bir geliştirme oturumu üretim limitlerini düşürebilir.
Kick, Twitch EventSub gibi WebSocket olaylarını destekliyor mu?
Henüz değil. Nisan 2026 itibarıyla webhook'lar tek push aktarımıdır. WebSocket aktarımı, KickEngineering/KickDevDocs deposunda Issue #20 olarak herkese açık takip edilir. Yayına girene kadar, herkese açık bir webhook URL'si barındıramayan masaüstü uygulamalarının sunucu tarafı bir röleye ihtiyacı olacak.