Support
Sağlayıcı hizmetlerinin API aracılığıyla SMM paneli kategorileriyle eşleştirilmesi

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" }

Sağlayıcı hizmet ID'sinin SMM paneli kategorisi ve vitrin kartıyla bağlantı şeması

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.

  1. Mevcut senkronizasyon döngüsü için bir tanımlayıcı oluşturun.
  2. İlk sayfayı isteyin ve alınan hizmetleri kaydedin.
  3. Her hizmet için last_seen_sync alanını döngü tanımlayıcısıyla güncelleyin.
  4. Bir sonraki isteği gerçekleştirmeden önce sonraki sayfanın imlecini kaydedin.
  5. 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

Sitenin yeni tasarımı

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..

15/08/2026 Yeni

News SP

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..

08/04/2026 Güncelleme

01.01.2026 tarihine kadar sizin için tüm mevcut promosyonları ve çekilişleri bir araya getirdik

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..

26/12/2025 Sona erdi

Kadrolar ve bayilerle işbirliği

Twitch hizmetleri istikrarlı bir şekilde çalışıyoruz, bu yüzden kadrolar, bayilerle işbirliği yapmaya hazırız, hizmet sahipleri, bot sahipleri ve ..

22/10/2025 Ortaklara

Twitch izleyicileri kararlı, ancak bazı nüanslar var.

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..

22/10/2025 Güncelleme

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

15/06/2025 Yeni

If YouTube is blocked, where to stream now?

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..

16/03/2022 Önemli

API SP

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..

02/09/2021 Ortaklara

ORTAKLAR VE YÖNLENDİRMELER: YENİ ŞARTLAR!

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..

12/08/2020 Ortaklara

İzleyici kontrol paneli [Twitch | Kick | YouTube | VK Video Live]

Kendi özel paketini oluştur
Bakiye yükleme, tek tıkla sipariş, indirimler ve bonuslar yalnızca kayıtlı kullanıcılar içindir. Kayıt ol.
Doğru hizmeti bulamadıysanız veya daha ucuzunu bulduysanız, Telegram destek ekibimize ya da sohbete yazın, her sorunu çözelim.

 

Streamer'lar için Hizmetlerimiz

 

İçerik Üreticileri için Hizmetlerimiz

 

Yeni

Telegram botu @BOT_SP_RU_BOT

Bir dakikada sipariş ve tekrar, bakiye ve sipariş durumları — doğrudan Telegram'da

Siparişi tekrarlaSipariş durumlarıBakiye yüklemePromosyon kodları