Announcements

ExpTech service announcements, the same content shown on the announcement site https://announcement.exptech.com.tw: service incidents, maintenance, updates, API changes, and similar notices. Only announcements that are published and not yet expired are returned. Use this to show ExpTech maintenance and incident status inside your own service.

Call this from your server

Right now this API allows only ExpTech’s own announcement site to read it cross-origin from a browser. A page on another origin that calls it with fetch is blocked by the browser’s CORS policy. Call it from your server, then pass the result to the frontend.

Data license

• Not applicable

  ExpTech's own service notices. Credit ExpTech when you republish them.

Where to show it, examples and commercial-use requests: Data licensing and attribution.

Authentication

No API Token is required right now.

Announcement object

All three endpoints return an announcement in this shape:

Field	Type	Description
id	int	Announcement ID.
type	int	Announcement type: 1 general, 2 incident, 4 maintenance, 8 update, 16 change.
title	string	Title.
content	string	Body, in Markdown. It may contain the summary separator {/* truncate */}, which you can remove before display.
tags	string[]	Tags. Examples: an affected service (TREM Lite, DPIP, API(HTTP), …) or an impact level (無 none, 小 small, 中 medium, 大 large, 重大 major). Incident and maintenance announcements include either 進行中 (in progress) or 已結案 (closed).
status	int	Status. The public API returns only published announcements, so this is always 1.
expires_at	string | null	Expiry time, ISO 8601 UTC (for example 2026-11-20T00:00:00.000Z). null when it does not expire.
created_at	string	Created time, ISO 8601 UTC.
updated_at	string	Last updated time, ISO 8601 UTC.

List announcements

Newest created_at first, 50 per page. Only announcements that are published and not yet expired are included.

GEThttps://announcement.exptech.com.tw/api/announcements

ServerAnnouncement

Query parameters

• pageintOptionalDefault 1

  Page number, starting at 1.

• searchstringOptional

  Keyword, matched against the title, body, and tags (partial match, case-insensitive).

• typeintOptional

  List only this type: 1 general, 2 incident, 4 maintenance, 8 update, 16 change. Only one type at a time.

Request

cURL

curl "https://announcement.exptech.com.tw/api/announcements"

JavaScript

const res = await fetch("https://announcement.exptech.com.tw/api/announcements");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get("https://announcement.exptech.com.tw/api/announcements", timeout=10)
res.raise_for_status()
print(res.json())

Response

200304

Success

{
  "success": true,
  "data": {
    "announcements": [
      {
        "id": 42,
        "type": 4,
        "title": "API 伺服器例行維護",
        "content": "11 月 20 日 02:00–04:00 進行例行維護，期間 API 可能短暫無法連線。",
        "tags": [
          "API(HTTP)",
          "小",
          "進行中"
        ],
        "status": 1,
        "expires_at": "2026-11-20T00:00:00.000Z",
        "created_at": "2026-11-14T03:00:00.000Z",
        "updated_at": "2026-11-14T03:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "totalPages": 1
  }
}

Show all（25 lines）

If-None-Match matches the ETag. Empty bodyNo response body

Try it

Query parameters

pageOptional

searchOptional

typeOptional

API token (optional)

Remember in this browserSend

The token is sent from your browser directly to the API.

Response fields

Field	Type	Description
success	boolean	true on success.
data.announcements	object[]	Announcements on this page. See Announcement object for the shape.
data.total	int	Total number of announcements that match.
data.page	int	Current page number.
data.totalPages	int	Total number of pages (50 per page). 0 when there are no announcements.

Counts by type

GEThttps://announcement.exptech.com.tw/api/announcements/stats

ServerAnnouncement

Request

cURL

curl "https://announcement.exptech.com.tw/api/announcements/stats"

JavaScript

const res = await fetch("https://announcement.exptech.com.tw/api/announcements/stats");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get(
    "https://announcement.exptech.com.tw/api/announcements/stats",
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response

200304

Success

{
  "success": true,
  "data": {
    "stats": {
      "1": 12,
      "4": 3,
      "8": 20
    }
  }
}

If-None-Match matches the ETag. Empty bodyNo response body

Try it

API token (optional)

Remember in this browserSend

The token is sent from your browser directly to the API.

Response fields

Field	Type	Description
data.stats	object	Announcement type → count of announcements that are published and not yet expired. The key is the type number as a string. A type with a count of 0 is omitted.

Get one announcement

GEThttps://announcement.exptech.com.tw/api/announcements/{id}

ServerAnnouncement

Path parameters

• idintRequired

  Announcement ID (path parameter).

Request

cURL

curl "https://announcement.exptech.com.tw/api/announcements/<id>"

JavaScript

const res = await fetch("https://announcement.exptech.com.tw/api/announcements/<id>");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get(
    "https://announcement.exptech.com.tw/api/announcements/<id>",
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response

200304404

Success

{
  "success": true,
  "data": {
    "announcement": {
      "id": 42,
      "type": 4,
      "title": "API 伺服器例行維護",
      "content": "11 月 20 日 02:00–04:00 進行例行維護，期間 API 可能短暫無法連線。",
      "tags": [
        "API(HTTP)",
        "小",
        "進行中"
      ],
      "status": 1,
      "expires_at": "2026-11-20T00:00:00.000Z",
      "created_at": "2026-11-14T03:00:00.000Z",
      "updated_at": "2026-11-14T03:00:00.000Z"
    }
  }
}

Show all（20 lines）

If-None-Match matches the ETag. Empty bodyNo response body

The announcement does not exist, or it is not published

{
  "success": false,
  "error": "找不到公告"
}

Try it

Path parameters

idRequired

API token (optional)

Remember in this browserSend

The token is sent from your browser directly to the API.

Response fields

The shape of data.announcement is the announcement object.

Notes

• Cache. The server caches for 10 seconds. The response includes ETag. The same If-None-Match returns 304.
• Expired announcements. The list and the counts omit expired announcements. Fetching one by ID still returns it as long as it is still published.
• Error format. An error response is {"success": false, "error": "<message>"}. An unknown path returns 404, and error is 找不到此路徑.
• Time format. Time fields are ISO 8601 UTC strings (ending in Z). Convert them to Taiwan time for display.
• Do not call this directly from a browser. See the CORS note above.