API của portal-be¶
🟢 16 hoàn thành · 🟡 0 đang làm · ⚪ 7 chưa làm — 14 endpoint · 9 dòng cấp story. Nguồn: openapi.yaml @ origin/main 24e5076 (cổng hợp đồng ở repo bảo đảm mỗi đường khai là route thật có test).
Cổng bên thứ ba — E-004/nhom-2¶
🟢 13 hoàn thành · 🟡 0 đang làm · ⚪ 2 chưa làm · tài liệu kỹ thuật của nhóm
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| 🟢 hoàn thành | POST |
/api/v1/tpp-users |
register |
E-004/2.1 Tài khoản người dùng của bên thứ ba |
Đăng ký tài khoản bên thứ ba |
| 🟢 hoàn thành | POST |
/api/v1/tpp-users/{id}/email-verifications |
issueVerification |
E-004/2.1 Tài khoản người dùng của bên thứ ba |
|
| 🟢 hoàn thành | POST |
/api/v1/tpp-users/{id}/email-verifications/confirm |
confirmVerification |
E-004/2.1 Tài khoản người dùng của bên thứ ba |
|
| 🟢 hoàn thành | POST |
/api/v1/tpp-sessions |
login |
E-004/2.8 Xác thực và phiên cho người dùng bên thứ ba |
Đăng nhập |
| 🟢 hoàn thành | DELETE |
/api/v1/tpp-sessions/current |
logout |
E-004/2.8 Xác thực và phiên cho người dùng bên thứ ba |
Đăng xuất |
| 🟢 hoàn thành | PUT |
/api/v1/tpp-users/current/password |
changePassword |
E-004/2.8 Xác thực và phiên cho người dùng bên thứ ba |
|
| 🟢 hoàn thành | GET |
/api/v1/submissions |
listSubmissions |
E-004/2.2 Đơn nộp hồ sơ |
|
| 🟢 hoàn thành | POST |
/api/v1/submissions |
createSubmissionDraft |
E-004/2.2 Đơn nộp hồ sơ |
Tạo bản nháp đơn |
| 🟢 hoàn thành | GET |
/api/v1/submissions/{id} |
getSubmission |
E-004/2.2 Đơn nộp hồ sơ |
|
| 🟢 hoàn thành | PUT |
/api/v1/submissions/{id} |
writeSubmissionDraft |
E-004/2.2 Đơn nộp hồ sơ |
Ghi bản nháp |
| 🟢 hoàn thành | POST |
/api/v1/submissions/{id}/submit |
submitSubmission |
E-004/2.2 Đơn nộp hồ sơ |
Nộp đơn |
| 🟢 hoàn thành | — |
— |
E-004/2.3 Chống lạm dụng đường đăng ký công khai |
không thêm đường (429 trên đường sẵn có) · change đã đóng: 2026-09-12-chong-lam-dung-dang-ky |
|
| ⚪ chưa làm | — |
— |
E-004/2.7 Nội dung pháp lý có phiên bản và vết đồng ý |
||
| ⚪ chưa làm | — |
— |
E-004/2.10 Giới hạn tốc độ ngoài đường đăng nhập và độ dài tối thiểu khi đổi mật khẩu |
không thêm đường | |
| 🟢 hoàn thành | — |
— |
E-004/2.11 Điểm cuối nhận tệp đính kèm cho đơn nộp và trả tệp cho chính người nộp |
change đã đóng: 2026-09-13-tep-dinh-kem-don-nop |
Ứng dụng — E-005/nhom-1¶
🟢 0 hoàn thành · 🟡 0 đang làm · ⚪ 1 chưa làm · tài liệu kỹ thuật của nhóm
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| ⚪ chưa làm | — |
— |
E-005/1.2 Đơn khai ứng dụng |
Yêu cầu đăng ký sản phẩm — E-005/nhom-2¶
🟢 0 hoàn thành · 🟡 0 đang làm · ⚪ 2 chưa làm · tài liệu kỹ thuật của nhóm
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| ⚪ chưa làm | — |
— |
E-005/2.5 Nộp yêu cầu đăng ký |
||
| ⚪ chưa làm | — |
— |
E-005/2.8 Đọc đặc tả API theo đăng ký |
Credential — E-005/nhom-3¶
🟢 0 hoàn thành · 🟡 0 đang làm · ⚪ 1 chưa làm · tài liệu kỹ thuật của nhóm
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| ⚪ chưa làm | — |
— |
E-005/3.3 Yêu cầu xoay khoá |
Công bố và báo cáo — E-007/nhom-1¶
🟢 0 hoàn thành · 🟡 0 đang làm · ⚪ 1 chưa làm · tài liệu kỹ thuật của nhóm
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| ⚪ chưa làm | — |
— |
E-007/1.3 Bề mặt công bố công khai |
Chưa xếp vào sổ¶
Endpoint có thật nhưng sổ chưa kê
Có trong openapi.yaml của repo mà so-api.tsv chưa có dòng ⇒ chưa biết thuộc nhóm và story nào. Làn docs kê bổ sung vào sổ; endpoint không mất, chỉ đứng ngoài cây nhóm.
| Đèn | Method | Đường | operationId | Story | Ghi chú |
|---|---|---|---|---|---|
| 🟢 hoàn thành | GET |
/api/v1/submissions/{id}/attachments |
listSubmissionAttachments |
? | |
| 🟢 hoàn thành | POST |
/api/v1/submissions/{id}/attachments |
attachSubmissionFile |
? | Gắn một tệp (PDF/JPEG ≤ trần cấu hình) vào nháp của mình; cùng loại thì tệp mới thay tệp cũ |
| 🟢 hoàn thành | GET |
/api/v1/submissions/{id}/attachments/{attachmentId} |
downloadSubmissionAttachment |
? |