Yönetim — USKO Takip

Yönetim anahtarı

Sunucuyu başlattığında konsolda yazar; ayrıca data/admin_token.txt dosyasında bulunur.

Toplu ilan ekle

Oyunda pazarları gezerken not aldığın ilanları satır satır yapıştır. Biçim:

Satıcı ; Tür ; Item ; Fiyat ; X ; Y
Bozkurt ; satış ; Shard(+7) ; 1.5m ; 815 ; 554
Ejder   ; alış  ; Lobo Pendant ; 25m ; 812,560
Kaan    ; s     ; Black Gem ; 160k

Ayraç: ; | veya sekme (Excel'den kopyalanabilir). Tür: satış / alış (s / b). Fiyat: 1500000, 1.500.000, 1.5m, 750k, 2gb. X ve Y isteğe bağlı. # ile başlayan satırlar atlanır.

Sunucu Bölge

Reklam alanları

Sitede dört reklam alanı var. Üst banner ve yan panel önce sponsor bannerlarını gösterir. Sponsor yoksa Google AdSense reklamı, o da yoksa üst bantta “reklam verin” çağrısı çıkar. Tablo altı ve sayfa altı yalnızca AdSense içindir. Alanların yerini görmek için siteyi /?reklam=onizle adresiyle aç.

Sponsor bannerları

Google AdSense

AdSense'i açma adımları

Siteyi gerçek alan adında yayına al (localhost'ta reklam çıkmaz).
adsense.google.com → siteyi ekle. Verilen ca-pub-… kimliğini yukarıya yazıp kaydet. Doğrulama kodu sitenin <head> kısmına otomatik eklenir.
ads.txt otomatik oluşturulur ve /ads.txt adresinden yayınlanır:

Site onaylanınca AdSense → Reklamlar → Reklam birimine göre → Görüntülü reklam ile dört birim oluştur. Her birimin data-ad-slot numarasını ilgili alana yaz.
AdSense → Gizlilik ve mesajlaşma → Avrupa düzenlemeleri mesajını aç. AB, İngiltere ve İsviçre ziyaretçileri için Google onaylı çerez onayı zorunludur.
Gizlilik politikası hazır: /gizlilik (sitenin alt kısmında bağlantılı).

Veri gönderme API'si

Pazar verisini otomatik göndermek için POST /api/ingest kullanılır. Anahtar X-Ingest-Token başlığında gönderilir. Yönetim anahtarı da geçerlidir; başkalarına vereceğin anahtarları data/ingest_tokens.txt dosyasına satır satır yaz.

Kurallar

Her pazarcı için gönderilen item listesi o pazarın güncel hâlidir: listede olmayan eski ilanları kapanır, yenileri açılır, aynı kalanların “son görülme” zamanı yenilenir.
"items": [] pazarın kapandığı anlamına gelir.
"full_snapshot": true o sunucunun tamamının tarandığını bildirir; gönderilmeyen pazarların hepsi kapatılır.
30 dakika boyunca yeniden gönderilmeyen ilanlar otomatik kapanır (app/config.py → LISTING_TTL).

Örnek

Tüm uç noktaların etkileşimli dokümanı: /docs