واجهة Xatools العامة: باورز xat وأسعار وبيادق وملصقات وعد تنازلي
JSON مجاني بدون تسجيل لموقعك أو بوتك أو تطبيقك. تُقرأ البيانات مباشرة من xat.com كل 5 دقائق (يُكتشف كل باور جديد تلقائيًا) وتُستكمل بأسعار التبادل من fair-trade. CORS مفتوح، والردود مخزنة مؤقتًا 5 دقائق.
https://api.xatools.net/v1جرّب مباشرة
يعمل في متصفحك على الواجهة الحقيقيةPulsa «Consultar» o elige un ejemplo.
Endpoints
جميعها تُرجع JSON مع code: 200 y updated (unix) لآخر تحديث. أضف ?pretty لعرضه منسقًا. أسماء الباورز لا تميز حالة الأحرف.
GET/v1/latestآخر باور بتفاصيل كاملة وعد تنازلي للقادم وأحدث 14 باورًا
الحقول: latest (التفاصيل الكاملة، انظر /v1/power)، countdown (انظر /v1/countdown)، recent[] (ملخص)، stickers[] (آخر الباورز التي تحتوي ملصقات).
GET/v1/countdownالعد التنازلي للباور القادم (إعلانات حقيقية فقط)
status: announced (إعلان رسمي من xat)، manual (محدد من فريق Xatools)، أو none (sin anuncio: no se estima ni se predice nada) o released (lanzado en las últimas 12 h). time (unix), iso, seconds_left, power (id y nombre si xat lo indica), max_per_user, amount, last (آخر باور)، median_interval_days. Announce.php se lee cada 60 s (relay propio), así que el contador aparece en cuanto xat lo anuncia; el power nuevo se detecta en ≤2 min y el contador se reinicia solo.
GET/v1/releasesسجل الإصدارات
announces[] (anuncios de xat registrados: seen, time, power_id, name, max_per_user, amount) y detected[] (cuándo apareció cada power en la tienda). El historial de un power concreto también va en /v1/power/{name} → history[].
GET/v1/powersالكتالوج الكامل (ملخص لكل باور)
المعاملات: q (نص في الاسم أو الوصف أو السمايلات)، status (unlimited, limited, epic, collection, subscription), category (group, stickers, ace, hug, game, epic, allpowers, new… أو اسم قسم في المتجر)، type (smiley, function, stickers, supers…), limit, offset, full=1 (يشمل السمايلات والبيادق والملصقات والعناق…).
GET/v1/power/{nombre|id}التفاصيل الكاملة لباور
id, name, status, type, category, short, long, store {xats|days, text}, trade {min, max, min_days, max_days} (fair-trade), released, released_int, categories[], smilies[], pawns[] {name, hat}, stickers[], stickers_total, hugs[], backgrounds[], aces[], effects[], frames[], collection {required[], pawns[], smilies[]}, images {icon, strip80, smiley}.
GET/v1/collections · /v1/collection/{nombre}المجموعات (super powers)
كل مجموعة: id, name, required[] {id, name} (الباورز المطلوبة حسب xat)، pawns[] (البيادق التي تفتحها)، smilies[].
GET/v1/pawnsبيادق xat النشطة
active[] {key, power_id, name, hat} مباشرة من xat (كود جاهز للاستخدام، مثل (hat#hJa)), time (الصلاحية) و fair_trade[] كمرجع.
GET/v1/stickers · /v1/stickers/{power}الباورز التي تحتوي ملصقات وقائمتها
GET/v1/pricesسعر المتجر ونطاق التبادل لكل الباورز
سعر المتجر حسب xat.com ونطاق التبادل حسب fair-trade، يُحدّث كل 6 ساعات.
GET/v1/hugs · /v1/aces · /v1/effects · /v1/backgrounds · /v1/free · /v1/typesالعناق والآسات والتأثيرات والإطارات والخلفيات لكل باور والسمايلات المجانية وأقسام المتجر
GET/v1/smiley/{código} · /v1/search?q=لأي باور ينتمي السمايل · بحث سريع
GET/v1/promoted?lang=es · /v1/announce · /v1/statusالدردشات المروّجة حسب اللغة · إعلانات xat · حالة الخدمة
GET/v1/user/{id|nick} · /v1/user/{id|nick}/online · /v1/user/{id|nick}/powersالمعرّف ↔ الاسم · هل هو متصل؟ · powers المستخدم والمكرّرة والناقصة
بيانات مباشرة من xat.com عبر بوت Xatools. تُحفظ الحالة دقيقة والـ powers 5 دقائق؛ لا يكشف xat عن powers المستخدم إلا عندما يراه البوت في دردشة (أو يرد على تحديد الموقع)، لذا قد يُرجع 404 حتى ذلك الحين. أيضاً /v1/room/{chat} (معلومات غرفة) و /v1/bot (حالة البوت). الواجهة: /usuario/.
مثال على الاستخدام
// JavaScript (navegador o Node 18+)
const r = await fetch('https://api.xatools.net/v1/latest');
const { latest, countdown } = await r.json();
console.log(latest.name, latest.store.text, latest.smilies);
if (countdown.time) console.log('Próximo power:', new Date(countdown.time * 1000));
// PHP
$j = json_decode(file_get_contents('https://api.xatools.net/v1/power/purple'), true);
echo $j['power']['trade']['min'] . ' - ' . $j['power']['trade']['max'] . ' xats';
// Python
import requests
p = requests.get('https://api.xatools.net/v1/powers', params={'status': 'limited', 'limit': 10}).json()
print([x['name'] for x in p['powers']])
Xatools غير تابع لـ xat.com. البيانات من مصادر xat.com العامة؛ الأسعار: fair-trade. إذا كان مشروعك يستخدمها بكثافة، خزّن الردود مؤقتًا 5 دقائق على الأقل.