REST API Overview

Base URL

https://mycal-api.huijun00100101.workers.dev/v1

All responses are JSON. CORS is open (Access-Control-Allow-Origin: *), so you can call the API directly from the browser.

None required. Every public endpoint is readable without an API key.

100 requests per minute per IP. Exceeding the limit returns HTTP 429 with an envelope:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Try again in 12s.",
    "retryAfter": 12
  }
}

For heavy read workloads, prefer the iCal feed or mirror the JSON data files from our GitHub repo into your own storage.

Every successful response is wrapped in a data envelope:

{ "data": <payload>, "meta": { "..." } }

Errors use a matching error envelope:

{ "error": { "code": "VALIDATION_ERROR", "message": "...", "suggestions": [] } }

See Errors for the full list of error codes.

Read endpoints include Cache-Control headers tuned by request type:

Request	TTL	Rationale
Current-year holidays	1 hour	New cuti peristiwa might be announced
Past-year holidays	24 hours	Historical data is stable
State list	24 hours	Rarely changes
`/holidays/today`	15 minutes	Same reason as current year