Sağlayıcı hizmetleri API aracılığıyla SMM paneli kartlarıyla nasıl ilişkilendirilir
Sağlayıcı kataloğunu panel vitrininden neden ayırmalısınız
Sağlayıcı API'si genellikle teknik bir katalog döndürür: harici ID, ad, fiyat, limitler, durum ve sipariş parametreleri. SMM panelinde aynı pozisyonun müşterinin anlayacağı bir yapıya yerleşmesi gerekir: platform, promosyon türü, coğrafya, bağlantı formatı, kitle kalitesi veya başlatma hızı.
Harici kataloğu işlemeden yayınlarsanız vitrinde teknik adlar, kopyalar ve kullanılamayan pozisyonlar görünür. Eşleme, satın alma mantığını müşteri kartından ayırır. Bir sağlayıcı hizmetinin panelde ayrı bir hizmet olması şart değildir.
API aracılığıyla hangi veriler alınmalı
Sağlayıcının ham verilerini vitrin ayarlarından ayrı tutun. Harici ID, panelin dahili tanımlayıcısıyla değiştirilemez: sipariş oluşturmak, durum almak, iptal etmek ve hataları çözmek için gereklidir. Son senkronizasyon zamanını ve tam API yanıtını veya anlık görüntüsünü saklamak da faydalıdır.
- Sağlayıcı tanımlayıcısı ve hizmetin harici ID'si.
- Ad, açıklama ve harici kategori.
- Satın alma fiyatı, para birimi ve hesaplama birimi.
- Minimum, maksimum hacim ve miktar adımı.
- Kullanılabilirlik durumu, kalan miktar ve geçici durdurma işareti.
- Bağlantı, giriş, yayın, yorum ve coğrafya gereksinimleri.
- Manuel başlatma, iptal, yeniden başlatma ve kısmi tamamlama işaretleri.
Otomatik içe aktarmanın dezavantajı, sağlayıcıların aynı alanları farklı adlandırması ve bazen eksik veri iletmesidir. Hizmet adı kalıcı bir bağlantı için uygun değildir: harici ID değişmeden ad değiştirilebilir.
Hizmet kataloğu isteği ve yanıtı örneği
API formatı sağlayıcıya bağlıdır, ancak mantık genellikle aynıdır: panel erişim anahtarını ve sayfa parametrelerini iletir, yanıt olarak bir hizmet dizisi alır. Örneğin, imleçli bir katalog isteği şöyle görünebilir:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Koşullu API yanıtı:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Yanıt alanları doğrudan vitrin kartına yazılmamalıdır. Önce doğrulanmalı, sağlayıcı kataloğunda saklanmalı ve dahili kurallarla eşleştirilmelidir. Yalnızca hazır kartla çalışmanın dezavantajı, içe aktarmanın müşteri adını, açıklamayı veya manuel seçilmiş kategoriyi üzerine yazabilmesidir.
Önce panelde kategori yapısını tanımlayın
İçe aktarmadan önce panelin taksonomisini belirleyin. Üst düzey genellikle platformu tanımlar, sonraki düzey eylemi: aboneler, görüntülemeler, tepkiler, yorumlar, yayın izleyicileri veya başka bir format. İçeride hizmetleri coğrafyaya, kitle türüne, hıza ve telafi koşullarına göre ayırabilirsiniz.
Her kategori için zorunlu özellikleri tanımlayın. Görüntülemeler için bu, bağlantı türü ve içerik formatı olabilir; aboneler için platform, coğrafya ve izin verilen profil türü. Aşırı ayrıntılı yapının dezavantajı, kataloğun bakımının zorlaşması ve benzer hizmetlerin yalnızca dahili nüanslarla farklılaşmaya başlamasıdır.
Sağlayıcı ve vitrin bağlantılarını ayrı tutun
Sağlayıcı hizmeti ile panel kartı arasındaki bağlantı ayrı bir tabloda veya varlıkta saklanmalıdır. Burada sağlayıcı, harici ID, dahili kart, kategori, fiyat kuralı, rota önceliği, yayın durumu ve son başarılı kontrol tarihi gereklidir.
Bu şema, kartın URL'sini değiştirmeden ve sipariş geçmişini kaybetmeden sağlayıcıyı değiştirmenize olanak tanır. JSON'da örnek bir eşleme satırı:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Bağlantılar farklı olabilir, ancak her biri için güncelleme kuralını önceden belirleyin.
- Benzersiz parametreleri ve sipariş formu varsa, bir sağlayıcı hizmeti — bir kart.
- Gereksinimler ve koşullar açısından uyumluysa, farklı sağlayıcıların birkaç hizmeti — bir kart.
- Vitrin bunu dile, segmente veya satış yöntemine göre ayırıyorsa, bir sağlayıcı hizmeti — birkaç kart.
Birden fazla sağlayıcıyı tek kartta birleştirmenin dezavantajı, hız, kullanılabilirlik ve gerçek yerine getirme koşullarının farklı olabilmesidir. Farklı bağlantı formatları, limitleri veya zorunlu alanları olan rotaları birleştirmeyin.
Kataloğu sayfa sayfa içe aktarın
Sağlayıcı kataloğu numara, ofset veya imleç aracılığıyla sayfalar halinde sunabilir. İlk yanıt mutlaka tüm hizmetleri içermez. API imleç, devam bağlantısı veya veri varlığına dair başka bir açık işaret ilettiği sürece bir sonraki sayfayı isteyin.
İmleçli sayfalamada işlem şöyle görünür: panel bir sayfa alır, tüm hizmetleri kaydeder, bunları mevcut döngüde bulundu olarak işaretler ve ancak sonra bir sonraki imlece geçer. next_cursor alanı yoksa, geçiş tamamlanmış sayılır.
- Mevcut senkronizasyon döngüsü için bir tanımlayıcı oluşturun.
- İlk sayfayı isteyin ve alınan hizmetleri kaydedin.
- Her hizmet için last_seen_sync alanını döngü tanımlayıcısıyla güncelleyin.
- Bir sonraki isteği gerçekleştirmeden önce sonraki sayfanın imlecini kaydedin.
- Tüm sayfalar başarıyla geçildikten sonra kataloğu mevcut döngüyle karşılaştırın.
Sayfaların sıralı yüklenmesinin dezavantajı, tam içe aktarmanın daha uzun sürebilmesidir. Paralel istekler süreci hızlandırır, ancak API sınırına takılma veya sayfaları kataloğun farklı durumlarında alma riskini artırır.
Tekrar senkronizasyonda kopya oluşturmayın
Mevcut bir hizmeti bulmak için bileşik anahtar kullanın: sağlayıcı tanımlayıcısı ve hizmetin harici ID'si. Her tekrar içe aktarmada önce bu çiftle kaydı arayın, ardından teknik alanları güncelleyin. Yeni kaydı yalnızca böyle bir anahtar yoksa oluşturun.
Tekilleştirme için ad, fiyat veya kategori kullanmayın. İki farklı hizmette bu değerler aynı olabilir ve sağlayıcı harici ID'yi değiştirmeden pozisyonu yeniden adlandırabilir. Vitrin bağlantıları için de benzersiz kontrol gereklidir: aynı rota görev yeniden çalıştırıldıktan sonra iki kez görünmemelidir.
Benzersizliği veritabanı düzeyinde sınırlamak faydalıdır: sağlayıcı kataloğu için supplier_id + external_service_id ve eşleme için supplier_id + external_service_id + showcase_card_id. Katı sınırlamanın dezavantajı, eski bir bağlantıdaki hata durumunda üzerine yeni bir kayıt oluşturmak yerine bunun açıkça düzeltilmesi gerekeceğidir.
Silinen ve kaybolan hizmetler nasıl bulunur
Bir hizmet ancak tüm sayfalar tamamen başarıyla geçildikten sonra kayıp sayılabilir. Senkronizasyon bir hata, istek limiti veya API kullanılamaması nedeniyle durduysa, kataloğun zaten yüklenmiş kısmında bulunmayan pozisyonlar silinmiş olarak işaretlenemez.
Tamamlanmış içe aktarmadan sonra bu sağlayıcının last_seen_sync değeri mevcut döngü tanımlayıcısına eşit olmayan hizmetlerini bulun. Bunlara "bulunamadı" veya "arşivlendi" durumu atanır, yeni siparişlerden kapatılır ve kontrole gönderilir. Harici ID, değişiklik geçmişi ve siparişlerle bağlantılar korunur.
Kaybolan hizmet silinmek yerine arşivlenmelidir. Sağlayıcı onu daha sonra kataloğa geri döndürebilir, yanıt filtresini değiştirebilir veya pozisyonu geçici olarak gizleyebilir. Aynı harici ID yeniden ortaya çıkarsa, arşiv bağlantısı bir sonraki içe aktarmada geri yüklenebilir.
Hizmetin harici ID'si değiştiğinde ne yapmalı
Sağlayıcı eski hizmet yerine yeni bir hizmet oluşturduysa, yeni harici ID otomatik olarak öncekinin devamı sayılamaz. Aynı ad ve fiyatta bile pozisyonun sipariş gereksinimleri, coğrafyası, kitle türü veya telafi koşulları değişmiş olabilir.
Eski bağlantıyı arşive taşıyın, rotayı satıştan kaldırın ve eski siparişler için saklayın. Yeni hizmeti ayrı bir kayıt olarak içe aktarın. Ardından teknik parametreler tamamen uyumluysa manuel olarak veya güvenli bir kuralla yeni bir eşleme oluşturun.
Ada göre otomatik eşleştirme işi hızlandırabilir, ancak dezavantajı siparişi uygun olmayan koşullara sahip başka bir hizmete gönderme riskidir. ID değişikliği için rotayı sessizce değiştirmek yerine "kontrol gerekli" durumunu kullanmak daha iyidir.
Eşlemeyi kararlı teknik alanlara göre yapılandırın
Hizmetlerin otomatik dağıtımını bir alanlar kümesine göre kurmak daha iyidir: platform, hizmet türü, coğrafya, bağlantı formatı, minimum hacim, ek parametreler ve durum. Örneğin, API uyumlu platform, promosyon türü ve ülke değerlerini iletiyorsa, bir hizmet coğrafyaya göre görüntüleme kategorisine girebilir.
Sağlayıcı yorum, profil listesi veya manuel başlatma gerektiriyorsa, rotayı standart sipariş formunda yayınlamayın. Gerekli alanlara sahip ayrı bir kart kullanın veya entegrasyon tamamlanana kadar hizmeti gizli tutun.
Ad yalnızca ek bir özellik olarak kullanılabilir. Böyle bir kuralın dezavantajı, sağlayıcının ifadeyi değiştirebilmesi, kısaltma ekleyebilmesi veya farklı bir yazım kullanabilmesidir. Kritik rotaları harici ID'ye ve doğrulanabilir yanıt parametrelerine bağlayın.
API verilerini ve kart ayarlarını ayırın
İçe aktarma, vitrin kartının tamamının üzerine yazmamalıdır. Satın alma fiyatı, limitler, kullanılabilirlik ve teknik parametreler genellikle sağlayıcıdan güncellenir. Müşteri adı, açıklama, görünürlük, gösterim sırası ve kâr marjı kuralları panelin dahili ayarları olarak kalır.
Her alan için doğruluk kaynağını belirleyin. Örneğin, minimum hacim API'den alınır, müşteri adı panelden gelir ve vitrin fiyatı satın alma maliyetine dayalı dahili kuralla hesaplanır. Böyle bir ayrım olmadan senkronizasyon, manuel olarak düzenlenmiş açıklamayı silebilir veya kategoriyi harici ada göre değiştirebilir.
Fiyat ve parametre değişikliklerini kontrol edin
Sağlayıcı fiyatı değiştirdiyse, vitrin fiyatını kartın kuralına göre yeniden hesaplayın ve para birimini, komisyonları ve izin verilen marjı kontrol edin. Fiyat yoksa, para birimi bilinmiyorsa veya koşullar belirgin şekilde değiştiyse, rotayı kontrol durumuna geçirmek daha iyidir.
Minimum, maksimum veya miktar adımı değiştiğinde sipariş formunu güncelleyin. Form yeni kısıtlamaları desteklemiyorsa, rotayı satıştan kaldırın. Aksi halde müşteri, sağlayıcının gönderimden sonra reddedeceği bir sipariş verir.
Bağlantı formatı, zorunlu alan, hizmet türü veya başlatma yöntemi değiştiyse, manuel kontrole kadar yeni siparişleri engelleyin. Katı engellemenin dezavantajı, bazı kartların vitrinden geçici olarak kaybolmasıdır, ancak bu uyumsuz siparişleri kabul etmekten daha güvenlidir.
API hatalarını ve istek sınırlamalarını işleyin
Bir isteğin hatası tüm kataloğu otomatik olarak kapatmamalıdır. Yetkilendirme hatalarını, hatalı istek, geçici kullanılamama ve istek sıklığı sınırlaması hatalarından ayırın. Her grup için ayrı bir senaryo gereklidir.
- Yetkilendirme hatasında bu sağlayıcıya yeni siparişleri durdurun ve erişimi kontrol edin.
- İstek formatı hatasında API yanıtını kaydedin ve entegrasyonu sonsuz tekrarlar olmadan düzeltin.
- Geçici hatada isteği artan bir beklemeyle tekrarlayın.
- Sıklık sınırlamasında mevcut imleci kaydedin ve görevi tekrara taşıyın.
Ertelenen senkronizasyon başarıyla tamamlanana kadar hizmetleri kayıp olarak işaretlemeyin. Agresif tekrarların dezavantajı, istek limitini daha hızlı tüketebilir ve kataloğu daha uzun süre güncel olmayan durumda bırakabilirsiniz.
Aktif siparişler için rotaları koruyun
Hizmet durumu ve sipariş durumu farklı varlıklardır. Hizmet yeni müşteriler için katalogdan kaybolabilir, ancak eski siparişler hâlâ yerine getiriliyor olabilir. Kartın veya rotanın arşivlenmesi, zaten oluşturulmuş siparişlerin durum sorgulamasını durdurmamalıdır.
Her sipariş için hizmetin harici ID'sini, siparişin harici ID'sini, gönderilen parametreleri, başlatma anındaki satın alma maliyetini ve durum geçmişini saklayın. Sağlayıcı kısmi tamamlama, iptal veya hata bildirirse, durumu panel kurallarına göre işleyin: iade, telafi, yeniden başlatma veya manuel kontrol.
Sipariş parametrelerinin anlık görüntüsünü saklamanın dezavantajı, daha fazla alan ve dikkatli bir veri şeması gerektirmesidir. Böyle bir anlık görüntü olmadan, sağlayıcı hizmeti daha sonra değiştirirse siparişin hangi koşullarla gönderildiği belirlenemez.
Eşlemeyi kartları yayınlamadan önce test edin
Yapılandırmadan sonra tam yolu kontrol edin: panelde sipariş oluşturma, rota seçimi, sağlayıcıya gönderim, harici ID'nin kaydedilmesi, durum alma, iptal ve kısmi tamamlamanın işlenmesi. Farklı limitler, bağlantılar ve zorunlu alanlara sahip hizmet gruplarını test edin.
Ayrıca tekrar içe aktarmayı, fiyat değişikliğini, başarılı tam geçişten sonra hizmetin kaybolmasını, sayfalamanın ortasında hatayı ve istek sıklığı sınırlamasını simüle edin. Bu, panelin eksik katalog yüklemesi nedeniyle çalışan rotaları arşivleyip arşivlemediğini gösterir.
Manuel hizmetlere ve yorumlu pozisyonlara özellikle dikkat edin. Bunların dezavantajı, standart panel formunun genellikle sağlayıcının beklediği tüm verileri iletmemesidir. Onlar için ayrı bir sipariş şablonu veya API entegrasyonu tamamlanana kadar gizli durum gereklidir.
Last Articles
Tasarım ve işlevsellikte neler değişti Siteyi, üzerinde çalışmayı daha hızlı ve kolay hale getirmek için güncelledik. Ana değişiklikler arayüz, kişis..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Tüm izleyicilerimiz için %15 indirim için "December2025" promosyon kodunu kullanın2. Yapılandırıcımızın ve en ucuz izleyici kategorisinin temel fiy..
Twitch hizmetleri istikrarlı bir şekilde çalışıyoruz, bu yüzden kadrolar, bayilerle işbirliği yapmaya hazırız, hizmet sahipleri, bot sahipleri ve ..
Biz Twitch görüntüleyici hizmetlerimizi tamamen güncelledik ve şimdi kararlı çalışıyor. İzleyiciler için yalnızca yüksek kaliteli IP adresleri kul..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Ortaklık hizmetleri ve yönlendirme programının büyük popülaritesi nedeniyle bir işbirliği tablosu oluşturduk. Özü çok basit: daha fazla canlı izleyici..
Streamer'lar için Hizmetlerimiz
İçerik Üreticileri için Hizmetlerimiz










