OpenAPI 示範

公開作品集 API

面向公開作品集數據的靜態只讀 JSON API，提供個人資料、履歷、項目及網誌元數據，不含私人聯絡訊息、管理數據、分析數據、密鑰及寫入操作。

OpenAPI JSON 示例回應

端點

根 Profile JSON

面向爬蟲及代理工具的機器可讀公開資料。

GET

/profile.json

根 CV JSON

機器可讀的公開履歷數據。

GET

/cv.json

根 Projects JSON

機器可讀的公開項目狀態數據。

GET

/projects.json

根 Certificates JSON

認證及學習狀態，不把未完成項目寫成已完成。

GET

/certificates.json

Well-Known Portfolio JSON

公開作品集清單，涵蓋項目、端點及聲明範圍。

GET

/.well-known/portfolio.json

公開搜尋索引

只使用公開內容的作品集助手搜尋記錄。

GET

/public/search-index.json

API 搜尋索引

公開搜尋記錄的版本化別名。

GET

/api/v1/search-index.json

API Profile

版本化公開資料、重點領域、語言及連結。

GET

/api/v1/profile.json

API CV

版本化公開經驗、教育、技能及公開內容數據。

GET

/api/v1/cv.json

API Projects

版本化項目摘要、狀態及技術標籤。

GET

/api/v1/projects.json

API Certificates

版本化認證及學習狀態數據。

GET

/api/v1/certificates.json

API Portfolio

版本化機器可讀作品集清單。

GET

/api/v1/portfolio.json

OpenAPI

此只讀 API 的 OpenAPI 3.1 文件。

GET

/openapi.json

示例

curl

curl https://robinhuang.nz/api/v1/profile.json

JavaScript

const profile = await fetch('/api/v1/profile.json').then((r) => r.json())

Python

import requests
profile = requests.get('https://robinhuang.nz/api/v1/profile.json', timeout=10).json()

安全模型

只讀 GET 端點於構建時生成。
不包含認證令牌、cookies、sessions 或憑證。
沒有公開寫入路由、留言、上載或用戶提交數據。
不包含私人聯絡收件箱、管理記錄、分析數據或倉庫檔案。
回應為同源靜態 JSON，採用短快取重新驗證。