Bảng điều khiển phù hợp cho tác vụ đơn lẻ. Nó không phù hợp khi môi trường staging cần hộp thư mới mỗi lần triển khai hoặc sản phẩm tạo tài khoản email trong lúc tiếp nhận khách hàng. API dành cho các trường hợp đó.
Gói Yearly cung cấp REST để gửi tác vụ, kiểm tra trạng thái và lấy kết quả vào hệ thống riêng. CI, bảng quản trị và công cụ nội bộ là các trường hợp phổ biến. Không đưa thông tin đăng nhập trả về vào nhật ký; chuyển chúng sang kho được phê duyệt.
Những gì thường được tự động hóa
- CI/CD: tạo 10 Gmail kiểm thử khi nhánh staging được triển khai
- Tiếp nhận: cấp hộp thư khi tổ chức mới đăng ký sản phẩm
- QA: cấp tài khoản mới cho bộ Playwright hoặc Selenium mỗi lần chạy
- Vận hành nội bộ: nút “tạo 50 Yahoo cho Dự án X”
Luồng tích hợp cơ bản
- 1Dùng gói Yearly và tạo khóa trong Dashboard → API
- 2Gửi `POST /tasks` với nhà cung cấp (`gmail`, `yahoo` hoặc `outlook`), số lượng và tùy chọn tên
- 3Lưu ngay `task_id` trong phản hồi
- 4Kiểm tra `GET /tasks/{id}` mỗi 30–60 giây đến trạng thái `completed` hoặc `failed`
- 5Lấy danh sách tài khoản từ chi tiết tác vụ và đồng bộ vào cơ sở dữ liệu
Không hoàn tất tức thì
Đừng chặn giao diện để chờ. Tác vụ 50 Gmail có thể mất 30–90 phút. Trả ID ngay và báo người dùng khi xong bằng cơ chế sẵn có: webhook, email hoặc backend kiểm tra.
Bảo mật bắt buộc
| Quy tắc | Lý do |
|---|---|
| Khóa chỉ ở backend | Đặt frontend sẽ làm lộ khóa |
| Mỗi môi trường một khóa | Rò rỉ staging không phá production |
| Đổi khóa định kỳ | Giới hạn thiệt hại khi bị lộ |
| Mã hóa mật khẩu lưu trữ | Đây là dữ liệu nhạy cảm |
| Ghi ID tác vụ, không ghi mật khẩu | Gỡ lỗi mà không lộ thông tin |
Khi có lỗi
- Có thể thành công một phần. Kiểm tra trạng thái từng tài khoản và thử lại lỗi trong tác vụ mới.
- Tuân thủ giới hạn tần suất; tăng khoảng chờ 30, 60 rồi 120 giây.
- Tác vụ `processing` hơn ba giờ? Ghi lại và cảnh báo; đừng tự cho là thất bại rồi tạo bản trùng.
- Lưu `task_id` trước khi kiểm tra. Nếu script lỗi, tiếp tục tác vụ cũ thay vì tạo mới.
Tài liệu API
Tham chiếu endpoint, dạng yêu cầu/phản hồi và header xác thực đầy đủ nằm trong API Access ở bảng điều khiển sau khi đăng ký Yearly.
Tạo tài khoản chỉ là giai đoạn đầu. Dùng hướng dẫn tích hợp công cụ liên hệ để bàn giao và quy trình cấp tài khoản email cho phê duyệt, quyền sở hữu, lưu trữ và ngừng dùng quanh API.