Boss Timer API보스 타이머 API
For fan sites and Discord servers. Last updated: November 20, 2026팬 사이트와 디스코드 서버를 위한 API. 최종 업데이트: 2026년 11월 20일
In short요약
- Every field boss and channel on Windia and Zenith: the last kill, whether it's confirmed, and when the spawn window opens and closes.
- Your players can report kills and take them back. Two of them agreeing confirm a kill, the same as on our boss pages.
- Private groups: timers only your site sees, for a guild or a party.
- Use the shared board, or keep a private one: your choice, per key.
- Free, by request. The one condition: a visible credit link to MapleQuest Tracker where the timers are shown, within 1 day. It's checked by itself.
- 윈디아와 제니스의 모든 필드 보스와 모든 채널: 마지막 처치 시간, 확정 여부, 리젠 시간대가 열리고 닫히는 시간.
- 유저가 처치를 제보하고 취소할 수 있습니다. 서로 다른 유저 2명이 같은 처치를 제보하면 확정됩니다 (보스 페이지와 같은 규칙).
- 비공개 그룹: 길드나 파티만 보는 전용 타이머.
- 공용 타이머를 쓰거나 비공개 타이머를 따로 둘 수 있습니다: 키마다 선택.
- 무료이며 신청제입니다. 조건은 하나: 타이머가 보이는 곳에 1일 안에 MapleQuest Tracker 크레딧 링크를 표시하는 것. 자동으로 확인됩니다.
Your keys내 키Credit크레딧Endpoints엔드포인트Reporting kills처치 제보Shared or private공용 또는 비공개Private groups비공개 그룹Rules and limits규칙과 제한
Your keys내 키
Loading…
Credit크레딧
Show a link to MapleQuest Tracker on the page that shows the timers (the page you gave in your request). Either a plain link or our badge works:
신청할 때 적은 페이지(타이머가 보이는 페이지)에 MapleQuest Tracker 링크를 표시해 주세요. 일반 링크나 배지 중 하나면 됩니다:
<a href="https://maplequesttracker.com/bosses/?ref=your-site.com">Boss timers by MapleQuest Tracker</a>
<a href="https://maplequesttracker.com/bosses/?ref=your-site.com"><img src="https://live.maplequesttracker.com/api/v1/badge.svg?site=your-site.com" width="236" height="28" alt="Boss timers by MapleQuest Tracker"></a>
Put your own site where it says your-site.com (it fills in by itself when you're signed in). There's nothing secret in it: your key never goes on the page.
your-site.com 자리에 내 사이트 주소를 넣으세요 (로그인하면 자동으로 채워집니다). 비밀 정보는 없습니다: 키는 페이지에 들어가지 않습니다.
How the check works: every 6 hours our server opens your page and looks for a link to maplequesttracker.com. If your page is built by script and the link isn't in the HTML, use the badge: when real visitors load it on your own site, that counts too.
A new key has 1 day (24 hours) to show the credit. If the link is missing you get a Discord message right away, and when the day is over the key stops by itself. The same goes later: if the link disappears, the key stops one day after (missing links are checked every hour). Put the link back and press Check now: it works again right away.
확인 방식: 6시간마다 서버가 페이지를 열어 maplequesttracker.com 링크를 찾습니다. 페이지가 스크립트로 만들어져 HTML에 링크가 없다면 배지를 사용하세요. 배지가 내 사이트에서 로드되면 그것도 크레딧으로 인정됩니다.
새 키는 1일(24시간) 안에 크레딧을 표시해야 합니다. 링크가 없으면 바로 디스코드 메시지가 가고, 하루가 지나면 키가 자동으로 멈춥니다. 나중에도 마찬가지로 링크가 사라지면 하루 뒤에 멈춥니다(링크가 없을 때는 매시간 확인). 링크를 다시 넣고 지금 확인을 누르면 바로 다시 작동합니다.
For Discord servers디스코드 서버의 경우
A key can also be for a Discord server whose own bot shows the timers. The credit there: add the MapleQuest Tracker bot to the server (add the bot), and show "Boss timers by MapleQuest Tracker" in your bot's timer messages, for example in the embed footer. We check every hour that our bot is still in the server; the same 1-day rule applies.
키는 자체 봇이 타이머를 보여주는 디스코드 서버용으로도 받을 수 있습니다. 이 경우 크레딧은: MapleQuest Tracker 봇을 서버에 추가하고 (봇 추가), 봇의 타이머 메시지에 "보스 타이머 제공: MapleQuest Tracker"를 표시하는 것입니다(예: 임베드 푸터). 저희 봇이 서버에 있는지 자동으로 확인하며, 같은 1일 규칙이 적용됩니다.
// discord.js embed footer
embed.setFooter({ text: "Boss timers by MapleQuest Tracker · maplequesttracker.com" });
Endpoints엔드포인트
Base address https://live.maplequesttracker.com. Send your key in a header: Authorization: Bearer mqt_… (or X-API-Key). Answers are JSON. Times are Unix seconds (UTC). world is windia (default, 40 channels) or zenith (10 channels).
기본 주소 https://live.maplequesttracker.com. 키는 헤더로 보내세요: Authorization: Bearer mqt_… (또는 X-API-Key). 응답은 JSON이고, 시간은 Unix 초(UTC)입니다. world는 windia(기본, 40채널) 또는 zenith(10채널).
| Call | What it gives내용 |
|---|---|
GET /api/v1/timers?world=&boss= | Every boss and channel: state (unknown, waiting, window, overdue), killed, window_opens, window_closes, source (confirmed or reported = one report so far), reports. Leave out boss for all bosses.모든 보스와 채널: state(unknown 모름, waiting 대기, window 리젠 가능, overdue 지남), killed, window_opens, window_closes, source(confirmed 확정 / reported 제보 1건), reports. boss를 빼면 전체 보스. |
GET /api/v1/kills?world= | The raw lists: confirmed kills and single reports.원본 목록: 확정 처치와 단일 제보. |
GET /api/v1/history?world=&boss= | Each channel's kills in the last 24 hours.채널별 최근 24시간 처치 기록. |
GET /api/v1/predict?world=&boss= | Respawn statistics measured from real kills.실제 처치로 측정한 리젠 통계. |
GET /api/v1/bosses | Boss names, respawn windows in minutes, page links.보스 이름, 리젠 시간대(분), 페이지 링크. |
GET /api/v1/worlds | Worlds and channel counts.월드와 채널 수. |
POST /api/v1/kills | Report a kill: {"boss":"Mano","channel":7,"world":"windia","user":"your-player-id"}. Optional: killed (Unix time, default now), name, group, share.처치 제보: {"boss":"Mano","channel":7,"world":"windia","user":"유저-id"}. 선택: killed(Unix 시간, 기본 지금), name, group, share. |
POST /api/v1/kills/cancel | Take a report back (same boss, channel, world, user; within 10 minutes). In a group: {"group":"…","id":123} any time.제보 취소(같은 boss, channel, world, user, 10분 이내). 그룹에서는 {"group":"…","id":123}로 언제든지. |
GET/POST /api/v1/groups | List your private groups, or make one: {"name":"Guild"}. Also /groups/update, /groups/delete.비공개 그룹 목록, 또는 만들기: {"name":"길드"}. /groups/update, /groups/delete도 있습니다. |
GET /api/v1/groups/ID/timers | A group's own timers (same shape as /timers). /groups/ID/kills lists them with ids.그룹 전용 타이머(/timers와 같은 형식). /groups/ID/kills는 id와 함께 목록. |
GET /api/v1/me | Your key: status, credit check, usage.내 키 상태, 크레딧 확인 결과, 사용량. |
curl -H "Authorization: Bearer $MQT_KEY" \
"https://live.maplequesttracker.com/api/v1/timers?world=windia&boss=Mano"
# {"ok":true,"world":"windia","now":1795200000,"bosses":{"Mano":{"respawn_min":60,"respawn_max":120,
# "channels":[{"channel":1,"state":"window","source":"confirmed","killed":1795195500,
# "window_opens":1795199100,"window_closes":1795202700,"reports":2}, …]}}}
Reporting kills처치 제보
Call the API from your server, never from the browser: the key is a secret. Send user with every report: your own id for the player (any text, we only keep a hash). Each of your players then counts as one reporter, with the same limits as on our boss pages, and two of them agreeing within 5 minutes confirm a kill for everyone.
API는 서버에서 호출하세요. 브라우저에서 호출하면 키가 노출됩니다. 모든 제보에 user를 보내 주세요: 유저를 구분하는 아이디(아무 텍스트, 해시만 저장). 그러면 유저 한 명이 제보자 한 명으로 계산되고(보스 페이지와 같은 제한), 5분 안에 2명이 같은 처치를 제보하면 모두에게 확정됩니다.
// Node.js (server side)
await fetch("https://live.maplequesttracker.com/api/v1/kills", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.MQT_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ boss: "Stumpy", channel: 12, world: "windia", user: String(member.id) })
});
Shared or private공용 또는 비공개
You choose for each key, when you ask for it, and you can switch any time on this page:
키마다 신청할 때 선택하고, 이 페이지에서 언제든지 바꿀 수 있습니다:
- Shared: your players' kills go to the shared board, together with everyone on MapleQuest Tracker and the Discord bot. More reporters, more timers, and two players agreeing confirm a kill.
- Private: your own board. Your players' kills never reach the shared board, and
/timersshows only your own kills (one report is enough). You can still read the shared board with?board=shared.
- 공용: 유저의 처치가 MapleQuest Tracker와 디스코드 봇의 모든 유저와 함께 공용 타이머에 들어갑니다. 제보자가 많을수록 타이머가 많아지고, 2명이 같은 처치를 제보하면 확정됩니다.
- 비공개: 내 사이트만의 타이머. 유저의 처치는 공용 타이머에 절대 가지 않고,
/timers는 내 처치만 보여줍니다(제보 1건으로 충분). 공용 타이머는?board=shared로 여전히 읽을 수 있습니다.
Private groups비공개 그룹
A group is a timer board only your key can see: for a guild, a party, or players you trust. Kills sent with "group":"ID" stay in the group and never reach the shared board. One report is enough in a group (you decide who's in it). Add "share":true to a report, or set it on the group, to also send it to the shared board. Up to 20 groups per key; group kills are kept 24 hours.
그룹은 내 키로만 볼 수 있는 타이머입니다: 길드, 파티, 믿을 수 있는 유저용. "group":"ID"와 함께 보낸 처치는 그룹 안에만 남고 공용 타이머에는 가지 않습니다. 그룹에서는 제보 1건으로 충분합니다(멤버는 직접 정하니까요). 공용 타이머에도 보내려면 제보에 "share":true를 넣거나 그룹 설정으로 켜세요. 키당 그룹 20개, 그룹 처치는 24시간 보관됩니다.
Rules and limits규칙과 제한
- Keys are given by request, to a Discord account, for one site or one Discord server. Up to 3 per account.
- Keep the credit link up. No credit, no key (see above), and it starts again by itself when the link is back.
- 120 reads a minute and 300 kill reports an hour per key. Cache
/timersfor 10 seconds or more: it doesn't change faster. - Only real kills from real players. Fake or automated reports get the key's reports wiped and the key closed.
- Nothing here reads the game. Every timer comes from players, so please don't tell your users it does.
- 키는 신청제이며 디스코드 계정과 사이트 하나 또는 디스코드 서버 하나에 발급됩니다. 계정당 최대 3개.
- 크레딧 링크를 유지해 주세요. 크레딧이 없으면 키가 멈추고, 링크가 돌아오면 자동으로 다시 작동합니다.
- 키당 읽기 분당 120회, 처치 제보 시간당 300건.
/timers는 10초 이상 캐시하세요 (그보다 빨리 바뀌지 않습니다). - 실제 유저의 실제 처치만 보내 주세요. 가짜나 자동 제보는 해당 키의 제보가 모두 삭제되고 키가 닫힙니다.
- 게임 데이터를 읽지 않습니다. 모든 타이머는 유저 제보로 만들어지니, 유저에게 그렇게 안내해 주세요.
Questions: .jrkiller on Discord.
문의: 디스코드의 .jrkiller.