get_material_upload_token (자재 파일 업로드 토큰 발급)
자재 관련 파일 업로드를 위한 Cloudflare 업로드 토큰을 발급합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/get_material_upload_token |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
해당 회사의 멤버 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
| supplier_id |
string |
O |
공급자 ID |
- |
| file_name |
string |
O |
업로드할 파일명 |
- |
| file_size |
number |
O |
파일 크기 (bytes) |
- |
| file_mime |
string |
O |
파일 MIME 타입 |
- |
| target_date |
string/timestamp |
O |
대상 날짜 |
- |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"supplier_id": "supplier789",
"file_name": "거래명세서_2024-03.pdf",
"file_size": 512000,
"file_mime": "application/pdf",
"target_date": "2024-03-15"
}
응답
성공 (200)
{
"message": "자재 파일 업로드 토큰 발급 완료",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
실패
| 코드 |
message |
원인 |
| 500 |
"존재하지 않는 공급자입니다." |
해당 공급자가 존재하지 않는 경우 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
참고
- 발급받은 토큰은 Cloudflare Worker 업로드 엔드포인트에서 사용합니다.
- 파일은
companies/{company_id}/sites/{site_id}/material_supplier/{supplier_id}/files 경로에 저장됩니다.
- 관련 API: [[add_material_supplier]], [[set_material_cost_data]]