Xóa tin tức

API này giúp bạn xóa một bài viết tin tức khỏi hệ thống theo id của bài viết.

⚠️Xóa vĩnh viễn — không thể khôi phục

Đây là thao tác xóa cứng (hard delete): bản ghi bị xóa hoàn toàn khỏi cơ sở dữ liệu và không thể khôi phục. Hãy chắc chắn về id trước khi gọi API này.

---

Endpoint

🔗Endpoint Staging

http DELETE https://staging-manage.api.miniai.vn/api/external/news/{id}

🔗Endpoint Production

http DELETE https://manage-api.miniap.vn/api/external/news/{id}

Lưu ý về đường dẫn

API tin tức nằm trực tiếp dưới /api/external/news, không có tiền tố /v1 như API sản phẩm hay đơn hàng.

Xác thực (Authentication)

Mọi request phải gửi kèm API key của bạn trong header:

Header	Giá trị	Yêu cầu
x-api-key	miniai-partner <API_KEY_CỦA_BẠN>	Bắt buộc

Tham số đường dẫn (Path Parameters)

Tham số	Kiểu	Yêu cầu	Mô tả
id	string	Bắt buộc	ID của tin tức cần xóa (ObjectId 24 ký tự hex, vd: 68c93dba802d36826bc45c9c)

API này không cần request body. Bạn có thể lấy id từ kết quả của Lấy danh sách tin tức hoặc từ phản hồi khi Khởi tạo tin tức.

Ví dụ Request

cURL (Staging)

curl -X DELETE 'https://staging-manage.api.miniai.vn/api/external/news/68c93dba802d36826bc45c9c' \
  -H 'x-api-key: miniai-partner <API_KEY_CỦA_BẠN>'

cURL (Production)

curl -X DELETE 'https://manage-api.miniap.vn/api/external/news/68c93dba802d36826bc45c9c' \
  -H 'x-api-key: miniai-partner <API_KEY_CỦA_BẠN>'

Phản hồi (Response)

Thành công trả về mã 200. Phản hồi chỉ gồm cờ success, không kèm dữ liệu của bài viết đã xóa.

Response

{
    "success": true
}

Lưu ý khi xóa

• Nếu cần giữ lại nội dung, hãy gọi Lấy danh sách tin tức để sao lưu bài viết trước khi xóa.
• Nếu chỉ muốn ẩn bài viết khỏi Mini App thay vì xóa hẳn, hãy dùng Cập nhật tin tức và đặt status thành inactive.

Lỗi thường gặp

Mã	Nguyên nhân
404	Không tìm thấy tin tức với id đã cho (hoặc đã bị xóa trước đó)
401	Thiếu header x-api-key, sai tiền tố miniai-partner , hoặc API key không hợp lệ
429	Vượt giới hạn số request (xem mục Giới hạn bên dưới)
500	id không đúng định dạng ObjectId (24 ký tự hex) hoặc lỗi hệ thống

Lỗi 404 - Không tìm thấy

{
    "error": "Resource not found",
    "message": "không tìm thấy tin tức"
}

Lỗi 429 - Quá giới hạn

{
    "error": "Too many requests, limit to 100 requests per minute"
}

Giới hạn (Rate limit)

100 request / phút

Mỗi gian hàng được gọi tối đa 100 request mỗi phút trên toàn bộ External API. Vượt quá giới hạn sẽ nhận mã 429.

Các bước tiếp theo

• Lấy danh sách tin tức — kiểm tra bài viết đã được xóa khỏi danh sách
• Khởi tạo tin tức — tạo bài viết mới
• Cập nhật tin tức — ẩn bài viết bằng status: inactive thay vì xóa