Verify Email
Mutation · verifyEmail
verifyEmail(token: String!): Boolean!
Xác minh email cho tài khoản mật khẩu đã đăng ký. Lấy token từ tham số token của liên kết gửi qua email sau khi gọi register hoặc resendVerificationEmail. Khi xác minh thành công, tài khoản có thể đăng nhập bằng email và mật khẩu. Mutation không tạo phiên đăng nhập.
Gửi qua HTTP POST /graphql. Không cần access token hoặc quyền thành viên workspace/conversation. Các mutation xác thực dùng chung giới hạn 20 lần/phút theo IP trên mỗi tiến trình API; vượt giới hạn trả RATE_LIMITED.
Input
| Đối số | Kiểu GraphQL | Bắt buộc | Quy tắc |
|---|---|---|---|
token | String! | Có | Token trong liên kết xác minh: đúng 64 ký tự hex viết thường. Không có mặc định; không thể bỏ qua hoặc gửi null. Token có hiệu lực 24 giờ kể từ khi được phát hành và chỉ dùng một lần. |
Output
Trả về Boolean!. true nghĩa là token đã được dùng để đánh dấu email của danh tính mật khẩu là đã xác minh. Không trả hồ sơ hoặc token phiên.
Ví dụ
mutation VerifyEmail($token: String!) {
verifyEmail(token: $token)
}
Biến minh họa:
{ "token": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }
Phản hồi khi token hợp lệ:
{ "data": { "verifyEmail": true } }
Token sai định dạng, hết hạn, đã dùng, hoặc đã bị thay bằng liên kết mới trả EMAIL_VERIFICATION_INVALID. Nếu hai yêu cầu cùng dùng một token, chỉ một yêu cầu xác minh thành công. Người dùng có thể yêu cầu gửi lại email xác minh để nhận liên kết mới.
Chữ ký operation được tạo từ GraphQL schema.