المطوّرون
هل تبني بوت ديسكورد أو طبقة بث أو موقع إحصاءات؟ لا تكشط الصفحات: البيانات المجمّعة المتاحة للعامة في الموقع متاحة هنا أيضًا بصيغة تقرؤها الآلة. لا حاجة إلى تسجيل أو مفتاح.
للعلم فقط. البيانات مطابقة لما يعرضه الموقع وقد تتأخر بضع ثوانٍ؛ ولا تُعدّ سجلًا رسميًا.
القواعد
- حدّ المعدّل لكل عنوان عميل: 60 طلب في الدقيقة كحد أقصى. بعد ذلك تحصل على
429؛ وتخبرك الترويسةRetry-Afterبعدد الثواني قبل إعادة المحاولة. - يوجد أيضًا حد إجمالي لكامل الواجهة: 3.000 طلب في الدقيقة كحد أقصى؛ وعند تجاوزه تحصل أيضًا على
429. - يمكن تخزين الردود مؤقتًا 15 ثانية (
Cache-Control: public, max-age=15)؛ لا فائدة من الطلب بوتيرة أسرع. - تحمل كل استجابة ترويسة
ETag؛ أعِد إرسالها فيIf-None-Matchلتحصل على304 Not Modifiedدون محتوى إذا لم تتغير البيانات. GETفقط. الردود بصيغة JSON بترميز UTF-8 وأسماء الحقول إنجليزية بنمط camelCase؛ ولا تُترجم أسماء اللعبة. يمكن استدعاؤها مباشرة من المتصفح (Access-Control-Allow-Origin: *)؛ دون ملفات تعريف ارتباط.- الأوقات بصيغة ISO 8601 بتوقيت Server مع فارق المنطقة الزمنية؛ وكل ردّ يحمل لحظة إنشائه في الحقل "updated".
- لا تُعطى إلا الحقول الظاهرة للعامة في الموقع. لا يوجد Endpoint لشخصية أو Guild أو عضو بعينه، ولا أرشيف ولا بحث.
- الإصدار في المسار (
/api/v1): إضافة الحقول متوافقة؛ أما حذف حقل أو تغيير معناه فإصدار جديد.
Endpoints
العنوان الأساسي https://seasro.com/api/v1
GET /api/v1/serverحالة Server: نسبة الامتلاء (occupancy، من 0 إلى 100 بخطوات 5؛ لا يُعطى عدد online اللحظي)، والقوافل على الطريق؛ اللاعبون النشطون (active: اللاعبون المختلفون الذين دخلوا خلال آخر 24 ساعة أو الموجودون في اللعبة الآن، مع القيم كل ساعة لآخر 7 أيام)؛ أعداد logs اليوم، وصيّاد Unique الأسبوع (weeklyHunter: فائز الأسبوع الماضي والمتصدّر هذا الأسبوع).
ردّ نموذجي
/api/v1/server{ "updated": "2026-11-20T23:53:54.8578397+03:00", "server": { "sampledAt": "2026-11-20T23:50:00+03:00", "occupancy": 0, "caravansOnRoad": 0 }, "active": { "players": 310, "calculated": "2026-11-20T23:53:30.9563422+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": 1704, "eventsByType": { "kervan": 0, "unique": 118, "arti": 0, "dusen": 2, "oldurme": 1082, "global": 502 } }, "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}أعلى 100 في ترتيب ما: المركز، الاسم، النقاط؛ ومعها Guild، Level في ترتيب الشخصيات.
الأنواع:
traderhunterthiefuniqueguildseviyeesya-puanialtinhonorunion-esya-puaniردّ نموذجي
/api/v1/rankings/trader{ "updated": "2026-11-20T23:53:54.8579753+03:00", "type": "trader", "rows": [ { "rank": 1, "name": "demoDoO", "score": 2245282, "level": 4 }, { "rank": 2, "name": "demoExternal", "score": 6074036, "level": 4 } ] }GET /api/v1/uniqueلوحة Unique: لكل Unique عدد مرات القتل وآخر قاتل والأكثر قتلًا؛ والأحياء منها الآن؛ وآخر عمليات القتل مع تفصيل الضرر.
ردّ نموذجي
/api/v1/unique{ "updated": "2026-11-20T23:53:54.8581365+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": 49444, "name": "Tiger Girl (Int)", "alive": true, "spawned": "2026-11-20T23:53:47.77+03:00" }, { "mobRefId": 38195, "name": "Apis", "alive": true, "spawned": "2026-11-20T23:27:05.537+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/eventsEvents الأيام السبعة القادمة: الاسم والبداية والنهاية إن عُرفت وهل هي جارية الآن.
ردّ نموذجي
/api/v1/events{ "updated": "2026-11-20T23:53:54.8583451+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/fortressesأصحاب Fortress: Fortress، Guild المالكة، نسبة الضريبة (من 0 إلى 1).
ردّ نموذجي
/api/v1/fortresses{ "updated": "2026-11-20T23:53:54.8584748+03:00", "fortresses": [ { "name": "Jangan Fortress", "guild": "demoSevenKin", "taxRate": 0 } ] }GET /api/v1/logbook/latest?type=…[&all=1]آخر 50 log في السجل، من الأحدث إلى الأقدم؛ وكل الأنواع إن لم يُحدَّد نوع. والافتراضي هو ما يبرز منها كما في الموقع؛ أما ظهور Unique وسائر logs فلا تأتي إلا مع tumu=1. ولا يحمل كل log إلا الحقول التي يعرضها الموقع لنوعه. أما Item المرتبطة برسالة Global ففي المصفوفة Items (الاسم، definition ID، التعزيز، rare).
قيم tur:
kervanuniqueartidusenoldurmeglobalردّ نموذجي
/api/v1/logbook/latest?type=global{ "updated": "2026-11-20T23:53:54.8585156+03:00", "type": "global", "events": [ { "kind": "global", "type": "global", "time": "2026-11-20T23:53:51.967+03:00", "character": "Aiz_CriminaL", "text": "BU NASI BİR DMG DÜZENİ AMK SPEAR ÇAR SWORD ÇARA METEORS 8K ATIYOR SWORD ÇAR YATIRLA 10K ATIYOR :D" }, { "kind": "global", "type": "global", "time": "2026-11-20T23:50:43.25+03:00", "character": "000", "text": "stat sıfırlama varmıydı" } ] }
النماذج ردود حقيقية من هذه اللحظة؛ واختُصرت القوائم الطويلة إلى أول عنصرين لتبقى مقروءة.
