Geliştiriciler
Discord botu, yayın katmanı ya da istatistik sitesi yapıyorsan sayfaları kazıma: sitede herkese açık olan toplu veri burada makinenin okuyabileceği biçimde de açık. Kayıt ya da anahtar gerekmez.
Bilgilendirme amaçlıdır. Veriler sitede gösterilenle aynıdır ve birkaç saniye gecikebilir; resmi kayıt yerine geçmez.
Kurallar
- Hız sınırı: istemci adresi başına dakikada 60 istek. Aşılınca
429döner;Retry-Afterbaşlığı kaç saniye sonra yeniden deneyeceğini söyler. - Ayrıca bütün API için toplam sınır: dakikada 3.000 istek; aşılınca yine
429döner. - Yanıtlar 15 saniye önbelleğe alınabilir (
Cache-Control: public, max-age=15); daha sık sormanın yararı yok. - Her yanıtta
ETagbaşlığı var; aynı değeriIf-None-Matchile gönderirsen veri değişmediyse gövdesiz304 Not Modifieddöner. - Yalnız
GET. Yanıtlar UTF-8 JSON, alan adları İngilizce camelCase; oyun içi adlar çevrilmez. Tarayıcıdan doğrudan çağrılabilir (Access-Control-Allow-Origin: *); çerez kullanılmaz. - Zamanlar ISO 8601, server saatiyle ve saat dilimi farkıyla; her yanıtta yanıtın kurulduğu an "updated" alanındadır.
- Yalnız sitede herkese açık görünen alanlar verilir. Tek karakter, Guild ya da üye endpoint'i yoktur; arşiv ve arama da yoktur.
- Sürüm yoldadır (
/api/v1): alan eklemek uyumlu sayılır; alan kaldırmak ya da anlamını değiştirmek yeni sürümdür.
Endpointler
Base URL https://seasro.com/api/v1
GET /api/v1/serverServer durumu: doluluk (occupancy, 0–100, 5'lik adım; anlık online sayısı verilmez), yoldaki kervan; aktif oyuncu (active: son 24 saatte oyuna giren ya da şu an oyunda olan farklı oyuncu ve son 7 günün saat başı değerleri); bugün çeteleye düşen log sayıları ve haftanın unique avcısı (weeklyHunter: geçen haftanın kazananı ve bu hafta önde olan).
Örnek yanıt
/api/v1/server{ "updated": "2026-11-20T23:46:03.8120182+03:00", "server": { "sampledAt": "2026-11-20T23:45:00+03:00", "occupancy": 0, "caravansOnRoad": 0 }, "active": { "players": 303, "calculated": "2026-11-20T23:45:30.6937523+03:00", "hourlyLast7Days": [ { "hour": "2026-11-14T00:00:00+03:00", "players": 495 }, { "hour": "2026-11-14T01:00:00+03:00", "players": 505 } ] }, "today": { "events": 1630, "eventsByType": { "kervan": 0, "unique": 117, "arti": 0, "dusen": 1, "oldurme": 1022, "global": 490 } }, "weeklyHunter": { "lastWeek": { "name": "demoSunFox", "kills": 10, "weekStart": "2026-11-09", "lastUnique": "Cerberus (Int)", "lastKill": "2026-11-13T02:10:13.407+03:00" }, "thisWeek": { "name": "Ozi_Siker", "guild": "ASGARD", "kills": 6, "weekStart": "2026-11-16", "lastUnique": "Uruchi", "lastKill": "2026-11-20T22:32:41.94+03:00" } } }GET /api/v1/rankings/{type}Bir sıralamanın ilk 100'ü: sıra, ad, puan; karakter sıralamalarında Guild ve Level.
Türler:
traderhunterthiefuniqueguildseviyeesya-puanialtinhonorunion-esya-puaniÖrnek yanıt
/api/v1/rankings/trader{ "updated": "2026-11-20T23:46:03.8122697+03:00", "type": "trader", "rows": [ { "rank": 1, "name": "demoDoO", "score": 2245282, "level": 4 }, { "rank": 2, "name": "demoExternal", "score": 6074036, "level": 4 } ] }GET /api/v1/uniqueUnique panosu: her unique'in kesilme sayısı, son keseni ve en çok kesenler; şu an hayatta olanlar; son ölümler ve hasar dökümü.
Örnek yanıt
/api/v1/unique{ "updated": "2026-11-20T23:46:03.8125026+03:00", "uniques": [ { "mobRefId": 48972, "name": "Khulood", "kills": 4, "lastKilled": "2026-11-20T23:37:57.743+03:00", "lastKiller": "SuS_V_IzLe", "topKillers": [ { "rank": 1, "name": "Kehlani", "kills": 3 }, { "rank": 2, "name": "SuS_V_IzLe", "kills": 1 } ] }, { "mobRefId": 48969, "name": "Karkadann", "kills": 4, "lastKilled": "2026-11-20T23:34:31.43+03:00", "lastKiller": "Kehlani", "topKillers": [ { "rank": 1, "name": "Kehlani", "kills": 1 }, { "rank": 1, "name": "Leria", "kills": 1 } ] } ], "status": [ { "mobRefId": 38195, "name": "Apis", "alive": true, "spawned": "2026-11-20T23:27:05.537+03:00" }, { "mobRefId": 49461, "name": "Khulood (Str)", "alive": true, "spawned": "2026-11-20T23:27:03.447+03:00" } ], "recentKills": [ { "mobRefId": 49460, "name": "Khulood (Int)", "time": "2026-11-20T23:37:57.743+03:00", "killer": "SuS_V_IzLe", "totalDamage": 14600138, "attackers": 4, "topDamage": [ { "rank": 1, "name": "SuS_V_IzLe", "damage": 4584281 }, { "rank": 2, "name": "SenseLivy", "damage": 4162198 } ] }, { "mobRefId": 49458, "name": "Karkadann (Int)", "time": "2026-11-20T23:34:31.43+03:00", "killer": "Kehlani", "totalDamage": 20355979, "attackers": 5, "topDamage": [ { "rank": 1, "name": "Kehlani", "damage": 5740186 }, { "rank": 2, "name": "SaykoN", "damage": 5498865 } ] } ] }GET /api/v1/eventsÖnümüzdeki yedi günün eventleri: ad, başlangıç, biliniyorsa bitiş, şu an sürüyor mu.
Örnek yanıt
/api/v1/events{ "updated": "2026-11-20T23:46:03.8129201+03:00", "events": [ { "name": "Battle Arena (Party)", "start": "2026-11-20T23:45:00+03:00", "end": "2026-11-21T00:05:00+03:00", "running": true }, { "name": "Medusa", "start": "2026-11-21T00:00:00+03:00", "running": false } ] }GET /api/v1/fortressesFortress sahipleri: Fortress, sahip Guild ve vergi oranı (0–1).
Örnek yanıt
/api/v1/fortresses{ "updated": "2026-11-20T23:46:03.8131632+03:00", "fortresses": [ { "name": "Jangan Fortress", "guild": "demoSevenKin", "taxRate": 0 } ] }GET /api/v1/logbook/latest?type=…[&all=1]Çetele'nin son 50 logu, yeniden eskiye; tür verilmezse bütün türler. Varsayılan, sitedeki gibi öne çıkan loglardır; unique çıkışları ve öteki bütün loglar yalnız tumu=1 ile gelir. Her logda yalnız o türün sitede görünen alanları vardır. Global mesaja bağlanan itemler items dizisindedir (ad, definition ID, artı, rare).
tur değerleri:
kervanuniqueartidusenoldurmeglobalÖrnek yanıt
/api/v1/logbook/latest?type=global{ "updated": "2026-11-20T23:46:03.813233+03:00", "type": "global", "events": [ { "kind": "global", "type": "global", "time": "2026-11-20T23:45:38.31+03:00", "character": "KarismaBende", "text": "PC VE IP LİMİTİ BİLEN VAR MI SİTE DE DE FORUMDA DA YAZMIYO" }, { "kind": "global", "type": "global", "time": "2026-11-20T23:45:13.43+03:00", "character": "MasterCakii", "text": "SELAMIN ALEYKÜM" } ] }
Örnekler bu anın gerçek yanıtlarıdır; okunur kalsın diye uzun listeler ilk iki öğeye kısaltıldı.
