create_certificate (자격증 생성)
새로운 자격증을 등록합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/create_certificate |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
요청
| 헤더 |
값 |
| Authorization |
Bearer {Firebase ID Token} |
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| name |
string |
O |
자격증명 |
최대 100자 |
| issuer |
string |
O |
발급기관 |
최대 100자 |
| grade |
string |
X |
급수/점수 |
최대 50자 |
| acquisition_date |
string |
O |
취득일 |
날짜 형식 (datetime 변환) |
| expiry_date |
string |
X |
만료일 |
날짜 형식 (datetime 변환) |
| image_url |
string |
X |
자격증 이미지 URL |
최대 500자 |
요청 예시
{
"name": "건설안전기사",
"issuer": "한국산업인력공단",
"grade": "기사",
"acquisition_date": "2019-06-15",
"expiry_date": "2029-06-15",
"image_url": "https://example.com/cert.jpg"
}
응답
성공 (200)
{
"message": "자격증 생성 완료",
"certificate_id": "생성된 자격증 ID"
}
실패
| 코드 |
message |
원인 |
| 400 |
필드 검증 오류 |
필수 필드 누락, 형식 오류 |
| 403 |
인증 오류 |
토큰 없음/만료 |
| 500 |
서버 오류 |
내부 오류 |
Firestore
- 경로:
users/{UID}/certificates/{certificate_id}
참고