编写REST API的PUT端点的最佳实践包括以下几个方面：

1. 使用PUT方法 PUT方法用于更新或替换资源。在API设计中，应该将PUT方法用于更新整个资源，而不是部分更新。如果要进行部分更新，请使用PATCH方法。

2. 使用正确的URI PUT请求应该发送到确定的URI，用于指定要更新的资源。URI应该是具有唯一标识符的资源的路径。例如，/api/users/{id}用于更新用户的信息，其中{id}是用户的唯一标识符。

3. 提供请求体 PUT请求应该包含一个请求体，用于传递更新后的资源信息。请求体可以是JSON、XML或其他格式，取决于API的设计和需求。

4. 处理错误情况 在处理PUT请求时，应该考虑各种可能的错误情况。例如，如果请求的资源不存在，应该返回404 Not Found；如果请求体中提供的数据格式不正确，应该返回400 Bad Request；如果更新操作失败，应该返回适当的错误状态码。

以下是一个使用Java和Spring Boot编写PUT端点的示例代码：

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @Autowired
    private UserRepository userRepository;

    @PutMapping("/{id}")
    public ResponseEntity updateUser(@PathVariable("id") Long userId, @RequestBody User updatedUser) {
        Optional optionalUser = userRepository.findById(userId);
        
        if (optionalUser.isPresent()) {
            User user = optionalUser.get();
            user.setName(updatedUser.getName());
            user.setEmail(updatedUser.getEmail());
            
            User savedUser = userRepository.save(user);
            return ResponseEntity.ok(savedUser);
        } else {
            return ResponseEntity.notFound().build();
        }
    }
}

上述代码中，PUT请求将更新用户的名称和电子邮件。首先，根据提供的用户ID从数据库中获取用户信息。如果找到用户，将更新用户的名称和电子邮件，并保存到数据库中。最后，返回更新后的用户信息。如果找不到用户，则返回404 Not Found状态码。