{
  "name": "Xatools API",
  "version": "1.7.0",
  "base": "https://api.xatools.net/v1",
  "docs": "https://xatools.net/api/",
  "license": "Uso libre con atribución a xatools.net",
  "sources": {
    "powers": "xat.com",
    "prices": "fair-trade",
    "gifts": "api.xatblog.net/usergifts",
    "room": "api.xatblog.net/chatinfo"
  },
  "endpoints": {
    "/v1/status": "Estado del servicio, última actualización, contadores",
    "/v1/powers": "Listado de powers (params: q, status, category, type, limit, offset, full=1)",
    "/v1/power/{name|id}": "Ficha completa de un power (smilies, peones, stickers, precios, colección)",
    "/v1/latest": "Último power + contador + últimos 14 powers",
    "/v1/countdown": "Contador del próximo power: solo si xat lo anuncia (Announce.php) o el equipo lo fija; nunca se estima",
    "/v1/collections": "Colecciones (super powers) con requeridos y peones",
    "/v1/collection/{name}": "Detalle de una colección",
    "/v1/pawns": "Peones activos según xat",
    "/v1/stickers": "Powers con stickers",
    "/v1/stickers/{name}": "Stickers de un power",
    "/v1/hugs": "Hugs y power que los desbloquea",
    "/v1/aces": "Aces",
    "/v1/effects": "Efectos y frames",
    "/v1/backgrounds": "Fondos por power",
    "/v1/free": "Smilies gratis de xat",
    "/v1/types": "Categorías de la tienda de xat",
    "/v1/smiley/{code}": "A qué power pertenece un smiley",
    "/v1/required/{código}": "Powers necesarios para un código de smiley completo, p. ej. (d#hat#hk)",
    "/v1/search?q=": "Búsqueda rápida por nombre/smiley",
    "/v1/prices": "Precio de tienda (xat.com) y rango de trade (fair-trade)",
    "/v1/promoted?lang=es": "Chats promocionados",
    "/v1/announce": "Anuncios de xat (Announce.php)",
    "/v1/releases": "Historial de lanzamientos detectados y anuncios registrados (también en /v1/power/{name}.history)",
    "/v1/user/{id|nick}": "ID ↔ nombre registrado (servicio bot)",
    "/v1/user/{id|nick}/online": "¿Está en línea? (servicio bot; xat no tiene REST público)",
    "/v1/user/{id|nick}/powers": "Powers de un usuario (servicio bot; solo si el bot lo ha visto)",
    "/v1/user/{id|nick}/gifts": "Gifts de un usuario (api.xatblog.net/usergifts, cualquier user)",
    "/v1/room/{chat}": "Info de una sala (api.xatblog.net/chatinfo)",
    "/v1/bot": "Estado del bot de Xatools (conectado, sala, sesiones)",
    "POST /v1/upload": "Sube un GIF/PNG/WEBP (multipart image + kind[, host=r2|imgbb|freeimage]) y devuelve el enlace directo (R2 propio, imgbb o freeimage.host, con respaldo automático)"
  },
  "limits": "Uso justo: ~120 peticiones/min por IP. Las respuestas se cachean 5 min; no hace falta consultar más a menudo."
}