News API (launcher)

Public news list API for the Fetamix PC launcher.

Base path: `/api/v1`.

Endpoint: `GET /site/news`.

Auth: none (public). Only active items within the publish window are returned.

Locales: `ko` | `en` | `ja` | `zh-CN` | `zh-TW` | `es` (default: `en`). Fallback order: requested locale → `en` → `ko` → first available translation.

Launcher needs only three fields: `title`, `publish_start` (date), `site_url` (link). On click, open a popup/WebView with `site_url`. That URL is a detail-only site page (`/news/{id}/detail?locale={requested locale}`) — no list, header, or footer. Do not call a detail REST API from the launcher.

No Authorization header is required.

API base URL

Live

https://api.fetamix.com/api/v1

Sandbox

https://api-sandbox.fetamix.com/api/v1

News list

Returns published news for the game. The launcher must pass `game_id=1` (Action Taimanin). Fetamix Store news is not used by the game.

• `game_id=1` → that game’s news only
• Optional `category`: `1` = Notice, `2` = Event. Omit for all.

For the launcher, use only: `title` · `publish_start` · `site_url`. (The JSON may include extra fields for other clients — ignore them.)

GET /site/news

GET {BASE_URL}/site/news?locale=ko&game_id=1 GET {BASE_URL}/site/news?locale=en&game_id=1 GET {BASE_URL}/site/news?locale=ko&game_id=1&category=1 GET {BASE_URL}/site/news?locale=ko&game_id=1&category=2

Full URL examples

Live: https://api.fetamix.com/api/v1/site/news?locale=ko&game_id=1
Sandbox: https://api-sandbox.fetamix.com/api/v1/site/news?locale=ko&game_id=1

Query parameters

Name	In	Description
locale	query	Optional. UI language. Default `en`.
game_id	query	Required for the launcher. Use `1`. Do not omit — omitting returns Fetamix Store news, which the game does not use.
category	query	Optional (list only). `1` = Notice, `2` = Event. Omit to return all categories.

Example response

[
  {
    "title": "July 23rd Maintenance Complete",
    "publish_start": "2026-08-05T15:43:00.000Z",
    "site_url": "https://fetamix.com/news/53/detail"
  }
]

Response fields (launcher)

Field	Type	Description
title	string	Localized title
category	number	1 = Notice, 2 = Event
publish_start	string \| null	Publish start datetime (ISO 8601). Use as the list date.
site_url	string \| null	Site detail URL for launcher popup/WebView. `{WEB_FRONTEND_URL}/news/{id}/detail?locale={requested locale}`. Use Live or Sandbox — the host matches the API you call. Live `fetamix.com`, Sandbox `sandbox.fetamix.com`. Opens the news body only — no site header, footer, or list.

Live: https://fetamix.com/news/{id}/detail
Sandbox: https://sandbox.fetamix.com/news/{id}/detail

Notes for launcher

• Call GET /site/news?game_id=1 only.
• Display `title` and `publish_start`; on click open `site_url` (`/news/{id}/detail?locale={requested locale}` popup page).
• Pass UI language as `locale`.
• Do not omit `game_id`. Store news is not needed for the game.