📘 ShortURL API Documentation

🔗 Tổng quan

Hệ thống API phục vụ cho việc rút gọn link nội bộ, phục vụ quản lý log lỗi và phân tích.

1. API tạo Short URL

Endpoint:

POST /api/ShortUrl

Request Body (JSON)

{
  "originalUrl": "<https://siemdc-stg.sendo.vn/en-US/app/search/search?q=log-queries>",
  "team": "TMS",
  "level": "Error"
}

Response (result)

{
  "id": 123,
  "originalUrl": "<https://siemdc-stg.sendo.vn/en-US/app/search/search?q=log-queries>",
  "shortenedUrl": "<https://alm-test.sendo.vn/api/r/abc12345>",
  "team": "TMS",
  "level": "Error",
  "createDate": "2025-07-01T10:45:00Z"
}

Luồng xử lý:

1. [ShortUrlController] nhận request từ client tại /api/ShortUrl.
2. Chờ _service.ShortenUrlAsync(vm) trong ShortUrlService tạo mới dữ liệu sau đó gán vào result
3. ShortenUrlAsync(vm):
   • Kiểm tra xem originalUrl đã tồn tại trong DB chưa:
     • ❌ Nếu có → throw exception “This URL already exists.”.
     • ✅ Nếu chưa → tạo mới:
       • Generate short code: Guid.NewGuid().ToString("N").Substring(0, 8)
       • Generate title:var generatedTitle = await GenerateTitleFromUrl(entity.OriginalUrl);
       • Gán shortenedUrl = BaseDomain + /r/ + shortCode
       • Lưu vào DB thông qua _repo.CreateAsync(entity)
       • Lưu tất cả thay đổi vào DB với SaveChangesAsync().
       • Trả về ShortUrlVM đã được map từ Entity.
4. Trả về result

2. Bulk Create

Endpoint