Cách REST để xác minh email là gì?

Question

Khi người dùng đăng ký ứng dụng web của tôi, tôi gửi email để xác minh hộp thư đến của mình. Trong email có một liên kết đến một tài nguyên như thế này:

GET /verify/{token} 

Kể từ khi tài nguyên đang được cập nhật đằng sau hậu trường, nó không phá vỡ các cách tiếp cận RESTful?

Tôi làm cách nào để thực hiện theo cách RESTful?

Answer 1

Bạn không phải là quá nhiều REST? Với xác minh e-mail bạn muốn người dùng có thể chỉ cần nhấp vào liên kết từ bất kỳ tác nhân người dùng thư nào mà anh ta đang sử dụng, vì vậy bạn sẽ nhận được một GET đơn giản trên máy chủ (được hiển thị dưới dạng siêu liên kết cho người dùng) với mã thông báo hoặc trong đường dẫn hoặc là một phần của chuỗi truy vấn:

GET http://example.com/verify-email/TOKEN 
GET http://example.com/verify-email?token=TOKEN 

Hoặc là tốt cho trường hợp sử dụng này. Nó không thực sự là một tài nguyên bạn đang nhận được hoặc tạo ra; chỉ là một kích hoạt cho một số quá trình trên backend.

Tại sao bạn cho rằng điều này có thể chạy nhanh trong thiết kế tốt?

Answer 2

Tùy thuộc vào bạn đang cố gắng làm gì.

Ứng dụng có kích hoạt email sau khi xác thực người dùng không? Nếu vậy, nó không phải là một phương pháp idempotent và bạn nên sử dụng POST.

Ví dụ:

POST /users/{id}/verify/{token} 

Nếu phương pháp này không có bất kỳ hậu quả bên cạnh việc cập nhật, tôi nghĩ rằng bạn nên sử dụng PUT.

Answer 3

Điều bạn đang nói không phải là REST. REST là cho máy để giao tiếp máy và không phải cho con người để giao tiếp máy. Bạn có thể phát triển một máy khách REST của bên thứ nhất, sẽ gửi kích hoạt tới dịch vụ REST.

Bạn có thể sử dụng xác minh của bạn URI trong trình duyệt để truy cập khách hàng REST:

# user follows a hyperlink in the browser manually 

GET example.com/client/v1/verify/{token} 
# asking the client to verify the token 

và sau đó khách hàng REST sẽ có được siêu liên kết để xác minh từ các dịch vụ REST và gửi đường bưu điện đến dịch vụ trong bối cảnh.

# the REST client follows the hyperlinks given by the service automatically 
# the REST client can run either on the HTTP client or server side 

GET example.com/api/v1 
# getting the starting page of the REST service 
# getting the hyperlink for verification 

POST example.com/api/v1/verification {token} 
# following the verification hyperlink 

Nếu bạn có máy chủ REST bên thứ nhất, thì yêu cầu HTTP tới dịch vụ REST sẽ chạy hoàn toàn trên máy chủ và bạn sẽ không thấy bất kỳ điều gì trong trình duyệt. Nếu bạn có một máy khách REST phía máy khách, thì bạn có thể gửi POST trong trình duyệt bằng AJAX CORS hoặc bạn có thể thử POST trực tiếp với một biểu mẫu HTML (không được khuyến nghị). Dù sao kích hoạt phải là POST hoặc PUT.