Giới thiệu

API Endpoint

https://eapi.uocnv.com/api
            

API này cho phép bạn tạo tài khoản email theo tên miền cá nhân, quản lý hộp thư, gửi email và truy xuất thông tin.

Tạo tài khoản email

                
curl -X POST "https://eapi.uocnv.com/api/create-user" \
    -H "Content-Type: application/json" \
    -d '{"email":"user1@example.com","password":"12345678","name":"Your Name","domain":"example.com"}'
                
            

Phương thức: POST :
Endpoint: /create-user

Phản hồi thành công :

{
  "success": true,
  "message": "User created successfully."
}
                

Params

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
email	string	✅	Địa chỉ email muốn tạo
password	string	✅	Mật khẩu đăng nhập
domain	string	✅	Đuôi domain tạo mail
name	string	✅	Tên hiển thị

Xóa tài khoản emaill

                
curl --location 'https://eapi.uocnv.com/api/delete-mailbox' \
--header 'Content-Type: application/json' \
--data-raw '{ "email": "testuser@example.com", "password": "12345" }'
                
            

Phương thức: DELETE :
Endpoint: /delete-user

Phản hồi thành công :

{
  "success": true,
  "message": "Mailbox deleted successfully"
}
                

Params

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
email	string	✅	Địa chỉ email muốn tạo
password	string	✅	Mật khẩu đăng nhập

Gửi email

                
curl -X POST "https://eapi.uocnv.com/api/send-email" \
    -H "Content-Type: application/json" \
    -d '{
        "from": "user1@example.com",
        "password": "12345678",
        "to": "receiver@example.com",
        "subject": "Chào bạn!",
        "text": "Nội dung email thử nghiệm"
    }'
                
            

Phương thức: POST :
Endpoint: /send-email
Xác thực:: Email + Password

Phản hồi thành công :

{
    "success": true,
    "messageId": ''
}


                

Params

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
from	string	✅	Địa chỉ email gửi đi
password	string	✅	Mật khẩu email gửi
subject	string	✅	Địa chỉ người nhận
to	string	✅	Tiêu đề email
text	string	✅	Nội dung email

Quản lý hộp thư

                
curl -G "https://eapi.uocnv.com/api/emails" \
    -d "email=user1@example.com" \
    -d "password=12345678" \
    -d "page=1" \
    -d "limit=10" \
    -d "openBox=INBOX" \
    -d "criteria=ALL"
                
            

Phương thức: GET :
Endpoint: /emails

Phản hồi thành công :
{
  "success": true,
  "emails": [
    {
      "uid": 123,
      "subject": "Tiêu đề email",
      "from": "sender@example.com",
      "date": "2024-02-26T10:00:00Z",
      "short_body": "Nội dung tóm tắt email...",
      "flags": ["\\Seen"]
    },
                 {
      "uid": 456,
      "subject": "Tiêu đề email",
      "from": "sender@example.com",
      "date": "2024-02-26T10:00:00Z",
      "short_body": "Nội dung tóm tắt email...",
      "flags": ["\\Seen"]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalMessages": 25,
    "totalPages": 3
  }
}
                

Params

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
email	string	✅	Địa chỉ email
password	string	✅	Mật khẩu tài khoản
page	int	❌	Trang dữ liệu (mặc định: 1)
limit	int	❌	Số lượng email mỗi trang (mặc định: 10)
openBox	string	❌	Hộp thư cần truy cập (mặc định: INBOX) - INBOX, Sent, Trash
criteria	string	❌	Điều kiện lọc (ví dụ: ALL, UNSEEN, FLAGGED,...)

Đọc nội dung thư

                
curl -G "https://eapi.uocnv.com/api/read-email" \
    -d "uid=12345" \
    -d "email=user1@example.com" \
    -d "password=12345678"
                
            

Phương thức: GET :
Endpoint: /read-email

Phản hồi thành công :
{
    "success": true,
    "message": "Đọc email thành công",
    "data": {
        "uid": 1,
        "subject": "Chủ đề",
        "from": "Địa chỉ gửi thư đến",
        "date": "Thời gian nhận thư",
        "body": "Nội dung thư"
    }
                

Params

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
uid	int	✅	uid của thư - Lấp từ API /emails
password	string	✅	Mật khẩu email gửi
email	string	✅	Địa chỉ email

Mã trả về

Code	Meaning
200	Thành công
400	Yêu cầu không hợp lệ
401	Không có quyền truy cập (Unauthorized)
404	Không tìm thấy tài khoản
500	Lỗi máy chủ nội bộ
301	Lỗi khác