GET /api/content — All Campus Locations and Stories

The /api/content endpoint is the primary data feed for the HNU-TimeLetter interactive map. It returns every campus location pinned on the SVG campus overlay, together with all galgame-style character stories nested under each location. The data is produced by the Feishu sync pipeline and written to src/data/content.json; the endpoint reads that file at request time, so new stories appear immediately after a sync completes — no build or server restart is needed.

Endpoint

GET /api/content

Authentication: None — this is a fully public endpoint. Query parameters: None.

Response — 200 OK

Returns a JSON object with a single top-level key, locations, containing an array of LocationPoint objects. Each LocationPoint embeds its own stories array.

{
  "locations": [
    {
      "id": "lib-001",
      "name": "图书馆",
      "x": 25,
      "y": 60,
      "stories": [
        {
          "id": "story_001",
          "characterId": "char_001",
          "characterName": "姬松",
          "avatarUrl": "https://oss.himematsu.cn/avatars/himematsu-q.png",
          "mainImageUrl": "https://oss.himematsu.cn/images/story_001_main.png",
          "content": "那天在图书馆，我第一次遇见了她……",
          "author": "Aki",
          "locationId": "lib-001",
          "locationName": "图书馆"
        }
      ]
    },
    {
      "id": "canteen-002",
      "name": "学生食堂",
      "x": 52,
      "y": 38,
      "stories": []
    }
  ]
}

Schema

locations

LocationPoint[]

required

Array of campus location points displayed on the SVG map overlay. Each entry carries its own nested story list.

Show LocationPoint fields

string

required

Location unique identifier. Uses a human-readable slug format, for example "lib-001" or "canteen-002".

name

string

required

Human-readable display name shown in the UI tooltip and story reader header, for example "图书馆".

number

required

Horizontal position of the pin on the SVG campus map, expressed as a percentage of the SVG viewport width. Range: 0–100.

number

required

Vertical position of the pin on the SVG campus map, expressed as a percentage of the SVG viewport height. Range: 0–100.

stories

Story[]

required

All galgame character stories attached to this location. May be an empty array if no stories have been synced yet.

Show Story fields

string

required

Story unique identifier, derived from the Feishu record ID (e.g. "story_001").

characterId

string

required

Identifier of the galgame character who narrates this story. Corresponds to 角色ID in the Feishu characters table.

characterName

string

required

Display name of the character. Injected from the Feishu characters table at sync time — not stored directly in the stories table.

avatarUrl

string

required

Full HTTPS URL of the character’s Q-version (chibi) avatar image, hosted on Aliyun OSS. Populated by the sync pipeline from the 头像OSS_URL field; the pipeline automatically uploads the original attachment if the OSS URL is missing.

mainImageUrl

string

required

Full HTTPS URL of the high-resolution story illustration, hosted on Aliyun OSS. Sourced from 大图OSS_URL with a fallback to the raw 大图 attachment field.

content

string

required

Full story text rendered inside the galgame-style story reader panel. Corresponds to 故事内容 in the Feishu stories table.

author

string

required

Name of the community contributor who submitted this story. Corresponds to 投稿人 in the Feishu stories table.

locationId

string

required

ID of the parent LocationPoint. Matches locations[].id and is used by the frontend to associate stories with map pins.

locationName

string

Human-readable name of the parent location. Optional — the frontend derives this from the enclosing LocationPoint.name when absent.

TypeScript example

interface Story {
  id: string;
  characterId: string;
  characterName: string;
  avatarUrl: string;
  mainImageUrl: string;
  content: string;
  author: string;
  locationId: string;
  locationName?: string;
}

interface LocationPoint {
  id: string;
  name: string;
  x: number;
  y: number;
  stories: Story[];
}

interface ContentResponse {
  locations: LocationPoint[];
}

async function fetchContent(): Promise<ContentResponse> {
  const res = await fetch("/api/content");
  if (!res.ok) {
    throw new Error(`Failed to fetch content: ${res.status}`);
  }
  return res.json() as Promise<ContentResponse>;
}

// Usage
const { locations } = await fetchContent();
const library = locations.find((loc) => loc.id === "lib-001");
console.log(`${library?.name} has ${library?.stories.length} stories`);

Data source

This endpoint reads src/data/content.json at runtime on every request. The file is generated by the Feishu sync pipeline, which pulls from the Feishu 地点表 (locations table) and 故事表 (stories table) and merges them into a single nested structure.Run npm run sync or trigger a sync from the admin dashboard to refresh the data. No build step and no server restart are required — the updated JSON is served immediately on the next request.

The sync pipeline writes two intermediate files during the locations+stories sync step:

File	Content
`src/config/locations.json`	Flat array of location metadata (id, name, x, y)
`src/data/content.json`	Merged `LocationPoint[]` with nested `Story[]` arrays

The /api/content endpoint serves exclusively from src/data/content.json.

Overview

Admin API

Frontend API

GET /api/content — All Campus Locations and Stories

Endpoint

Response — 200 OK

Schema

TypeScript example

Data source

Build docs developers (and LLMs) love

Overview

Admin API

Frontend API

Documentation Index

​Endpoint

​Response — 200 OK

​Schema

​TypeScript example

​Data source

Build docs developers (and LLMs) love

Endpoint

Response — 200 OK

Schema

TypeScript example

Data source