API Endpoints¶

Swagger UI¶

FastAPI tự động generate API documentation. Truy cập:

• Local: http://localhost:8000/docs
• Production: https://api.chienle.dev/docs

Endpoints Reference¶

Root¶

Courses¶

Chi tiết từng Endpoint¶

POST /courses — Tạo khóa học¶

Request:

{
  "title": "Khóa học Python cơ bản",
  "content_html": "<p>Nội dung khóa học...</p>"
}

Response (201):

{
  "id": 1,
  "title": "Khóa học Python cơ bản",
  "slug": "khoa-hoc-python-co-ban",
  "content_html": "<p>Nội dung khóa học...</p>",
  "thumbnail_key": null,
  "thumbnail_url": null
}

GET /courses — Danh sách khóa học¶

Query Parameters:

Response:

[
  {
    "id": 5,
    "title": "Khóa học React",
    "slug": "khoa-hoc-react",
    "thumbnail_url": "https://cdn.chienle.dev/courses/5/abc.jpg"
  }
]

POST /courses/{id}/upload-url — Lấy Presigned URL¶

Request:

{
  "file_name": "thumbnail.png",
  "content_type": "image/png"
}

Response:

{
  "upload_url": "https://r2.cloudflarestorage.com/...(presigned)...",
  "file_key": "courses/1/uuid-abc.png"
}

POST /courses/{id}/finalize-upload — Xác nhận Upload¶

Request:

{
  "file_key": "courses/1/uuid-abc.png"
}

Response: CourseResponse với thumbnail_url đã cập nhật.

Upload Flow¶

sequenceDiagram
    participant FE as Frontend
    participant BE as Backend (FastAPI)
    participant R2 as Cloudflare R2

    FE->>BE: POST /courses/{id}/upload-url
    BE->>BE: Generate presigned URL (boto3)
    BE-->>FE: { upload_url, file_key }
    FE->>R2: PUT upload_url (binary file)
    R2-->>FE: 200 OK
    FE->>BE: POST /courses/{id}/finalize-upload
    BE->>BE: Update course.thumbnail_key
    BE-->>FE: Updated CourseResponse