ตัวอย่างการใช้งาน API นักข่าว

<script src="https://bitnewsth.qd.je/widget.js" data-theme="news" data-lang="th" data-chart="true" data-chart-range="6h" data-interval="30" async></script>

กำลังโหลดข้อมูล...

fetch('https://bitnewsth.qd.je/api/public/server-status')
  .then(res => res.json())
  .then(data => {
    console.log(data.server.status);       // online | offline | maintenance
    console.log(data.server.playerCount);  // จำนวนผู้เล่น
    console.log(data.server.maxPlayers);   // ความจุเซิร์ฟเวอร์
    console.log(data.roster.departments);  // รายชื่อผู้เล่นแยกตามหน่วยงาน (v1.1.0)
    console.log(data.joinUrl);            // ลิงก์เข้าเซิร์ฟเวอร์
    // ต้องแสดงเครดิต "ข้อมูลจาก API นักข่าว BIT NEWS" คู่กับสถานะที่นำไปแสดง
  })
  .catch(err => console.error('โหลดสถานะไม่สำเร็จ', err));

{
  "ok": true,
  "api": "BIT NEWS Journalist API",
  "apiVersion": "1.1.0",
  "server": {
    "status": "online",
    "statusText": "เปิดให้บริการ",
    "statusLabel": "เปิดให้บริการขณะนี้",
    "playerCount": 6,
    "maxPlayers": 50,
    "queueCount": 0,
    "staffCount": 2,
    "capacityPercent": 12
  },
  "session": {
    "openedAt": "2026-10-12T06:27:05.000Z",
    "openedForMs": 1980000,
    "closedAt": "2026-10-12T07:00:47.000Z",
    "closedForMs": 2940000
  },
  "roster": {
    "listedPlayerCount": 6,
    "departments": [
      { "key": "1556545073297100871", "name": "ประชาชน", "emojiUrl": "https://cdn.discordapp.com/emojis/1556545073297100871.png", "count": 2,
        "players": [ { "name": "NEW4024v", "badge": null }, { "name": "popkark27", "badge": null } ] },
      { "key": "1550999320587927702", "name": "Bit Cities Police Department", "emojiUrl": "https://cdn.discordapp.com/emojis/1550999320587927702.png", "count": 1,
        "players": [ { "name": "BoqR_64", "badge": "PD-01" } ] }
    ]
  },
  "movement": {
    "lastJoin":  { "name": "popkark27", "badge": null, "at": "2026-10-12T07:48:00.000Z", "atLabel": "12 ตุลาคม 2569" },
    "lastLeave": { "name": "NEW4024v", "badge": null, "at": "2026-10-12T07:45:00.000Z", "atLabel": "12 ตุลาคม 2569" }
  },
  "notice": "เซิร์ฟเวอร์ไม่ได้เปิดให้บริการตลอด 24 ชั่วโมง เวลาเปิดให้บริการอาจเปลี่ยนแปลงตามจำนวนผู้เล่นและผู้ดูแล",
  "joinUrl": "https://erlc.gg/join/BIT",
  "updatedAt": "2026-10-12T07:50:12.000Z",
  "credit": {
    "required": true,
    "text": "ข้อมูลจาก API นักข่าว BIT NEWS",
    "provider": "BIT NEWS",
    "url": "https://bitnewsth.qd.je/server-status",
    "terms": "https://bitnewsth.qd.je/terms"
  }
}

{
  "ok": true,
  "api": "BIT NEWS Journalist API",
  "apiVersion": "1.1.0",
  "range": "24h",
  "rangeLabel": "24 ชั่วโมง",
  "rangeMs": 86400000,
  "sampleCount": 288,
  "fields": ["at", "players", "queue", "staff", "maxPlayers", "status"],
  "points": [
    { "at": 1790982600000, "players": 12, "queue": 0, "staff": 1, "maxPlayers": 50, "status": "online" },
    { "at": 1790983200000, "players": 27, "queue": 3, "staff": 2, "maxPlayers": 50, "status": "online" },
    { "at": 1790983800000, "players": 0,  "queue": 0, "staff": 0, "maxPlayers": 50, "status": "offline" }
  ],
  "updatedAt": "2026-10-03T05:10:00.000Z",
  "credit": {
    "required": true,
    "text": "ข้อมูลจาก API นักข่าว BIT NEWS",
    "provider": "BIT NEWS",
    "url": "https://bitnewsth.qd.je/server-status",
    "terms": "https://bitnewsth.qd.je/terms"
  }
}

async function loadChartPoints(range = '24h') {
  const res = await fetch(
    'https://bitnewsth.qd.je/api/public/server-status/history?range=' + range,
    { headers: { Accept: 'application/json' } }
  );
  if (!res.ok) throw new Error('โหลดไม่สำเร็จ: HTTP ' + res.status);
  const data = await res.json();

  // เวลาสิ้นสุด = ปัจจุบัน, เริ่มต้น = ย้อนหลังตาม rangeMs
  const endAt = Date.now();
  const startAt = endAt - data.rangeMs;

  // แปลงจุดเป็นพิกัด: x ตามเวลา, y ตามจำนวนผู้เล่น
  const xOf = at => ((at - startAt) / data.rangeMs) * chartWidth;
  const maxPlayers = Math.max(...data.points.map(p => p.players || 0), 1);
  const yOf = v => chartHeight - (v / maxPlayers) * chartHeight;

  // วาดเส้น (ข้ามจุดที่ players = null ได้)
  const path = data.points
    .filter(p => p.players != null)
    .map((p, i) => (i ? 'L' : 'M') + xOf(p.at) + ' ' + yOf(p.players))
    .join(' ');

  // อย่าลืมแสดงเครดิต "ข้อมูลจาก API นักข่าว BIT NEWS" ใต้กราฟ
  return { points: data.points, path, credit: data.credit };
}

let etag = null;

async function fetchStatus() {
  const headers = { Accept: 'application/json' };
  if (etag) headers['If-None-Match'] = etag;      // ส่ง ETag รอบเก่ากลับไป

  const res = await fetch('https://bitnewsth.qd.je/api/public/v1/server-status', { headers });
  if (res.status === 304) return null;            // ไม่มีอะไรเปลี่ยน — ไม่ต้องอัปเดตจอ

  etag = res.headers.get('ETag');                 // เก็บไว้ใช้รอบหน้า

  const limit = res.headers.get('X-RateLimit-Remaining');
  if (Number(limit) < 5) console.warn('ใกล้เกินโควต้าแล้ว เหลือ ' + limit);

  const data = await res.json();
  // อย่าลืมแสดงเครดิต "ข้อมูลจาก API นักข่าว BIT NEWS"
  return data.server;
}

{
  "ok": true,
  "api": "BIT NEWS Journalist API",
  "apiVersion": "1.1.0",
  "range": "24h",
  "rangeLabel": "24 ชั่วโมง",
  "rangeMs": 86400000,
  "summary": {
    "sampleCount": 17280,
    "peakPlayers": 43,
    "peakAt": "2026-10-08T13:20:00.000Z",
    "minPlayers": 0,
    "avgPlayers": 24,
    "peakQueue": 6,
    "avgQueue": 1,
    "uptimePercent": 31,
    "openHours": 7.4,
    "maintenanceHours": 0,
    "offlineHours": 16.6,
    "hasData": true
  },
  "updatedAt": "2026-10-08T18:45:00.000Z",
  "credit": { "required": true, "text": "ข้อมูลจาก API นักข่าว BIT NEWS" }
}

const source = new EventSource('https://bitnewsth.qd.je/api/public/server-status/stream');

source.addEventListener('snapshot', (ev) => {
  const data = JSON.parse(ev.data);      // มาครบชุดหนึ่งรอบ ตอนเพิ่งเชื่อมต่อ
  render(data.server);
});

source.addEventListener('status', (ev) => {
  const data = JSON.parse(ev.data);      // ส่งต่อก็ต่อเมื่อค่าเปลี่ยนจริง
  render(data.server);
});

source.onerror = () => {
  // browser จะพยายาม reconnect เอง หากเน็ตหลุด
  console.warn('สตรีมหลุด กำลังลองใหม่...');
};

// อย่าลืมแสดงเครดิต "ข้อมูลจาก API นักข่าว BIT NEWS" ใต้สถานะที่นำไปแสดง