OpenAPI 데모

공개 포트폴리오 API

공개 포트폴리오 데이터를 위한 정적 읽기 전용 JSON API입니다. 프로필, CV, 프로젝트, 블로그 메타데이터를 제공하며 비공개 연락 메시지, 관리자 데이터, 분석 데이터, 시크릿, 쓰기 작업은 제외합니다.

엔드포인트

루트 Profile JSON

크롤러와 에이전트를 위한 기계 판독용 공개 프로필입니다.

GET
/profile.json

루트 CV JSON

기계가 읽을 수 있는 공개 CV 데이터입니다.

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이며 짧은 캐시 재검증을 사용합니다.