콘텐츠로 이동

certificates 스키마

워크마루 사용자 자격증 문서의 전체 스키마. 이력서 문서 내 certificates 배열과는 별개의 원본 저장소입니다.

저장 위치

users/{uid}/certificates/{certificate_id}
  • 사용자 프로필에 귀속되는 자격증 원본 저장소입니다.
  • 이력서 문서의 certificates 배열과는 독립적으로 관리됩니다.

문서 필드

필드 타입 설명
name string 자격증명 (최대 100자)
issuer string 발급기관 (최대 100자)
grade string? 급수/점수 (최대 50자, 선택)
acquisition_date timestamp 취득일 (date 타입으로 검증 후 datetime 변환)
expiry_date timestamp? 만료일 (선택, 없으면 무기한)
image_url string? 자격증 이미지 URL (최대 500자, 선택)
created_at timestamp 생성 시각 (KST)
updated_at timestamp 최종 수정 시각 (KST)

이력서 내부 certificates와 필드 차이

  • 이력서 임베딩 버전(resumes.md 참조)은 acquired_date를 YYYY-MM 문자열로 저장합니다.
  • 본 컬렉션(users/{uid}/certificates)은 acquisition_date를 날짜 기반 timestamp로 저장하며, 만료일과 이미지 URL을 추가로 관리합니다.

예시 문서

{
  "name": "건설안전기사",
  "issuer": "한국산업인력공단",
  "grade": "기사",
  "acquisition_date": "2019-06-15T00:00:00+09:00",
  "expiry_date": "2029-06-14T00:00:00+09:00",
  "image_url": "https://cdn.example.com/cert/abc123.png",
  "created_at": "2026-04-23T10:00:00+09:00",
  "updated_at": "2026-04-23T10:00:00+09:00"
}

관련 엔드포인트