Xây dựng dựa trên Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

Khóa API Xác thực Điểm cuối cốt lõi Mã lỗi

Khóa API

Tạo khóa API dành cho nhà phát triển từ trang tổng quan của bạn. Mỗi khóa chỉ được hiển thị đầy đủ một lần, sau đó được lưu dưới dạng hàm băm an toàn để xác minh trong tương lai.

Tạo khóa từ bảng điều khiển đã đăng nhập của bạn.
Giữ chìa khóa riêng tư và lưu trữ chúng trong trình quản lý bí mật của riêng bạn.
Thu hồi các khóa cũ bất cứ khi nào thiết bị, tập lệnh hoặc đồng đội không còn cần quyền truy cập.

Xác thực

Sử dụng mã thông báo Bearer trong tiêu đề Cấp phép cho mọi yêu cầu được bảo vệ.

Authorization: Bearer YOUR_API_KEY

Nếu khóa không hợp lệ, bị thu hồi hoặc bị thiếu, API sẽ phản hồi bằng lỗi xác thực.

Điểm cuối cốt lõi

Quy trình làm việc phổ biến nhất là: kiểm tra người dùng đã xác thực, tạo hộp thư đến, sau đó tìm nạp thư từ hộp thư đến đó.

Kiểm tra tài khoản hiện tại

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Tạo hộp thư đến

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Tìm nạp tin nhắn hộp thư đến

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Phản hồi JSON mẫu

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Giới hạn tỷ lệ

Run2Mail áp dụng giới hạn yêu cầu dựa trên gói và giới hạn tạo hộp thư đến hàng ngày để bảo vệ dịch vụ và giữ quyền truy cập API ổn định.

Giới hạn tốc độ mỗi phút tùy thuộc vào gói hoạt động của bạn.
Giới hạn tạo email được theo dõi riêng biệt với các cuộc gọi đọc cơ bản.
Việc sử dụng được ghi lại để hiển thị bên trong bảng điều khiển phân tích của quản trị viên.

Mã lỗi

401: Thông tin xác thực API bị thiếu hoặc không hợp lệ.
403: Quyền truy cập bị chặn, hạn chế hoặc không được phép đối với yêu cầu.
429: Khối lượng yêu cầu đã vượt quá giới hạn hiện tại.
503: API nhà phát triển tạm thời bị nền tảng vô hiệu hóa.

Sắp có ảnh chụp màn hình API trang tổng quan

Khu vực này được dành riêng cho các ảnh chụp màn hình trong tương lai của bảng thông tin sử dụng và trình quản lý khóa API.

API Nhà phát triển