Portfolio API
A multi-backend RESTful API that serves portfolio data for the portfolio website. Implemented in four languages — TypeScript, Go, Rust, and Haskell — all returning identical JSON responses. Bilingual (Japanese/English) support via ?lang=en query parameter.
Backends
| Backend | Framework | Port | Directory |
|---|
| TypeScript | ElysiaJS | 3004 | ts/ |
| Go | Chi | 3005 | go/ |
| Rust | Actix Web | 3006 | rust/ |
| Haskell | Scotty | 3007 | haskell/ |
TypeScript is the source of truth. All other backends mirror its data and response format.
API Endpoints
All endpoints are under /api/ and return JSON. Most support ?lang=en for English (default: Japanese).
| Endpoint | Description |
|---|
GET / | Welcome message with endpoint list |
GET /health | Health check |
GET /api/profile | Personal profile |
GET /api/experience | Professional experience |
GET /api/projects | Project portfolio |
GET /api/skills | Technical skills |
GET /api/other-skills | Other skills |
GET /api/education | Educational background |
GET /api/contact | Contact information |
GET /api/certifications | Certifications |
GET /api/changelogs | Changelogs |
GET /api/faqs | FAQs |
GET /api/links | External links |
GET /api/strong-points | Strong points |
GET /api/notifications | Notifications |
GET /api/articles | Articles (fetched from Qiita) |
GET /api/download-pdf | Download resume as PDF (?format=compact|executive|technical|academic|modern) |
Project Structure
portfolio-api/
├── ts/ # TypeScript backend (source of truth)
├── go/ # Go backend
├── rust/ # Rust backend
├── haskell/ # Haskell backend
├── packages/ # Shared type package (@shinguakira/portfolio-api-types)
├── public/images/ # Production images (served by Vercel)
├── scripts/ # Utility scripts (image sync, etc.)
└── vercel.json # Vercel deployment config
Getting Started
TypeScript
cd ts
npm install
npm run dev # Start dev server on port 3004
npm test # Run tests (vitest)
npm run build # Compile TypeScript
Go
cd go
go mod tidy
go run . # Start REST (port 3005) + gRPC (port 50051) servers
go test ./... # Run tests
The Go backend also exposes the same data over gRPC (default port 50051,
override with GRPC_PORT) alongside REST. Server reflection and the standard
health service are enabled. See go/docs/grpc-guide-ja.md
for a beginner-friendly explanation (terminology, REST vs gRPC, how to regenerate
code and test with grpcurl).
Rust
cd rust
cargo run # Start server on port 3006
cargo test # Run tests
Haskell
cd haskell
stack build
stack exec portfolio-api-haskell # Start server on port 3007
stack test # Run tests
Deployment
Deployed on Vercel. The vercel.json routes:
/images/* → public/images/ (static assets)/icons/* → ts/public/icons/ (static assets)/api/* and / → TypeScript backend
Image Sync
Root public/images/ is the production source of truth. Use the sync script to keep ts/public/images/ in sync for local dev:
node scripts/sync-public.mjs # Sync root → ts
node scripts/sync-public.mjs --reverse # Sync ts → root
node scripts/sync-public.mjs --dry-run # Preview changes
License
MIT
