Đọc thư Outlook Hotmail bằng OAuth: hướng dẫn sử dụng

Không đăng nhập bằng mật khẩu

Dòng kết nối có mật khẩu vì định dạng nguồn gồm bốn trường, nhưng bộ đọc hiện tại dùng refresh token và Client ID để yêu cầu quyền truy cập. Nhập đủ dòng không có nghĩa Microsoft sẽ chấp nhận. Token cần còn dùng được và có quyền cho phương thức đọc đã chọn.

Biết phạm vi kết quả

Công cụ lấy tối đa mười lăm thư mới nhất trong hộp thư đến, không quét mọi thư mục. Một mã nằm trong thư rác hoặc thư cũ hơn có thể không xuất hiện. Khi danh sách có ít hơn mười lăm thư, đó có thể là số thư hiện có, không tự động là lỗi kết nối.

Mở trang qua dịch vụ chạy trên máy

Đọc thư cần bộ xử lý phía máy, nên chạy mo-doc-mail.cmd và dùng địa chỉ localhost do cửa sổ server thông báo. Trang mở bằng đường dẫn file có thể hiển thị giao diện nhưng không đủ để gọi bộ đọc thư. Cổng có thể thay đổi nếu phiên trước đang sử dụng cổng mặc định. Dùng trang tự mở hoặc kiểm tra địa chỉ của phiên mới thay vì truy cập một đường dẫn cũ. Khi mã server được cập nhật, cần khởi động lại dịch vụ; làm mới trình duyệt chỉ tải lại phần giao diện và không thay mã Python của tiến trình đang chạy.

Chọn phương thức theo quyền đang có

Microsoft Graph API và OAuth2 qua IMAP là hai cách kết nối khác nhau. Graph lấy thư bằng yêu cầu HTTPS, còn IMAP dùng kết nối hộp thư để tìm và đọc nội dung. Quyền của token phải phù hợp với phương thức; có quyền ở cách này không đảm bảo có quyền ở cách kia. Giao diện cho phép chọn và hiển thị phương thức đang dùng để bạn theo dõi. Nếu không biết phạm vi token, kiểm tra nguồn cấp hoặc quy trình đồng ý của ứng dụng. Không thể suy ra quyền chỉ từ email, mật khẩu hay hình thức của chuỗi refresh token.

Theo dõi tiến trình và phân biệt thông báo

Sau khi bấm đọc, nút bị vô hiệu trong lúc chờ và dòng trạng thái cho biết đang kết nối theo phương thức nào. Thành công sẽ hiện số thư trả về cùng các thẻ nội dung. Nếu lỗi, đọc mô tả trước khi đổi dữ liệu. Từ chối xác thực thường liên quan token hoặc quyền; không kết nối được thường liên quan mạng, proxy, tường lửa hoặc thời gian chờ. Đây là các nhóm nguyên nhân khác nhau. Đừng sửa mật khẩu trong nguồn để xử lý lỗi mạng, vì mật khẩu không tham gia luồng OAuth của bộ đọc hiện tại.

Dùng nút chuyển phương thức khi cần

Khi yêu cầu thất bại, giao diện đưa ra nút chuyển sang phương thức còn lại và đọc lại. Nút này giúp thử một lựa chọn có thể phù hợp hơn, không hứa sửa được mọi lỗi. Nếu Graph hoạt động còn IMAP thất bại, có thể dùng Graph để đọc thư trong phiên; việc đó không tự sửa quyền IMAP. Nếu cả hai thất bại, kiểm tra token, Client ID và mạng thay vì thử liên tục. Một yêu cầu bị hủy hoặc quá thời gian cũng cần xem xét kết nối trước khi kết luận rằng hộp thư không tồn tại hoặc không có thư.

Đọc đúng phạm vi của danh sách kết quả

Phiên bản hiện tại lấy tối đa mười lăm thư mới nhất trong hộp thư đến. Nó không bao gồm mọi thư mục và không tải toàn bộ lịch sử. Nếu tài khoản chỉ có ba thư trong phạm vi này, ba thẻ có thể là kết quả đúng. Nếu thư cần tìm nằm trong thư rác hoặc thư mục riêng, hãy xem bằng giao diện hộp thư chính thức. Công cụ không tự gửi yêu cầu tạo mã cho dịch vụ khác. Bạn cần thực hiện yêu cầu xác minh ở dịch vụ đó, chờ thư mới tới rồi đọc lại để kiểm tra thời gian và nội dung.

Đối chiếu mã với nội dung của thư

Bộ tìm số hiện tại có thể đưa ra các dãy bốn đến tám chữ số hoặc dạng ba số nối ba số làm gợi ý sao chép. Không phải mọi dãy đều là mã xác minh: năm, số tham chiếu hoặc phần địa chỉ mạng cũng có thể bị nhận diện. Mở Xem nội dung thư để đọc câu yêu cầu dùng mã và đối chiếu tiêu đề. Chọn đúng thư gắn với phiên xác minh hiện tại; mã trong thư cũ có thể không còn được chấp nhận. Nút sao chép chỉ đưa số vào clipboard, không xác nhận hiệu lực và không tự đăng nhập.

Nội dung văn bản và giới hạn hiển thị

Thẻ thư hiển thị tiêu đề, người gửi, thời gian và nội dung dạng văn bản. Những hình ảnh, nút định dạng hoặc bố cục HTML có thể không giống giao diện Outlook vì trang không dựng trực tiếp HTML từ người gửi. Cách hiển thị này phục vụ đọc và đối chiếu, không thay thế ứng dụng thư đầy đủ. Địa chỉ người gửi hoặc tiêu đề quen thuộc chưa đủ chứng minh thư đáng tin; bộ đọc không có chức năng đánh giá giả mạo. Khi cần xử lý liên kết, tệp đính kèm hoặc thư mục khác, dùng công cụ phù hợp và kiểm tra mục đích riêng.

Thông tin được gửi đi đâu khi đọc thư

Thông tin nhập được chuyển tới dịch vụ cục bộ trên máy để thực hiện OAuth và đọc thư từ Microsoft. Vì vậy, khác với phép tách văn bản, tính năng đọc thư thực sự có kết nối mạng. Server hiện tại không chủ động ghi token, mật khẩu hay nội dung thư ra tệp lịch sử. Điều đó không xóa dữ liệu ở clipboard hoặc phần mềm khác trên máy. Không đưa token vào ô tên trước và sau của bộ tách vì các ô đó lưu lịch sử. Khi chia sẻ lỗi, dùng thông báo và cấu trúc giả, tránh ảnh chứa trọn token thật.

Câu hỏi thường gặp

Có cần kiểm tra lại dữ liệu sau mỗi lần thay đổi không?

Có. Khi thay đổi đầu vào, hãy kiểm tra trạng thái và kết quả mới trước khi dùng. Đừng dựa vào kết quả của phiên trước để xác nhận cho nguồn vừa chỉnh. Với thao tác sao chép, đối chiếu thông báo thành công cùng nội dung bạn định chuyển. Nếu xảy ra lỗi, đọc mô tả ngay tại công cụ và xử lý đúng phần bị báo. Dữ liệu ví dụ trong bài chỉ để thực hành, không dùng để đăng nhập hoặc thử kết nối một hộp thư thật.

Làm sao biết đã hoàn tất đúng mục tiêu của bài?

Hãy xác nhận bạn đã hiểu vấn đề được nêu ở hai phần đầu, thực hiện bước phù hợp trong công cụ và kiểm tra giới hạn của kết quả. Một mã đã xuất hiện, một thẻ đã tách hoặc một danh sách thư đã tải là kết quả của chức năng tương ứng, không chứng minh tất cả dữ liệu nguồn đúng. Nếu mục đích tiếp theo là xác minh ở một dịch vụ khác, cần thực hiện bước đó riêng. Sau cùng, xóa dữ liệu trong trang khi không còn dùng và kiểm tra nơi đã sao chép.