260715_0

docs/wiki/pages/B06_wf3_ProfileCross/B06_api.md

@@ -0,0 +1,28 @@
+---
+type: page-api
+status: stable
+page_id: B06_wf3_ProfileCross
+related_pages: ["[[B06_wf3_ProfileCross/B06_frontend]]", "[[B06_wf3_ProfileCross/B06_backend]]", "[[B06_wf3_ProfileCross/B06_db]]"]
+last_updated: 2026-07-12
+source: 상위 프로젝트 B06_wf3_ProfileCross_Router.py 실 코드 직접 확인 (2026-07-12)
+---
+
+# B06_wf3_ProfileCross — API
+
+기본 prefix: `/api/projects` (`B06_wf3_ProfileCross_Router.py:33`). 공통 세션·오류 형식은 [[../../concepts/auth_rbac]], [[../../concepts/api_common]]을 참조한다.
+
+| 항목 | 위치 | 역할 |
+|---|---|---|
+| `POST /{project_id}/sections/generate` | `B06_wf3_ProfileCross_Router.py:48` | 확정 경로 기반 종단·횡단 생성 및 DB 저장 |
+| `GET /{project_id}/sections/{route_id}` | `B06_wf3_ProfileCross_Router.py:151` | 종횡단 결과 요약 조회 |
+| `POST /{project_id}/sections/{route_id}/confirm` | `B06_wf3_ProfileCross_Router.py:169` | 해당 route의 종횡단 결과 확정 |
+
+## 생성 응답
+| 항목 | 역할 |
+|---|---|
+| `longitudinal_id` | 종단면 레코드 ID |
+| `cross_section_count` | 생성된 횡단면 수 |
+| `length_m` | 대상 경로 총연장 |
+| `longitudinal_file_path` | 종단면 산출 파일 상대경로 |
+
+오류는 표준 `{"status":"error","message":...}` 형식으로 반환한다.