/**
  * Retrieves DiamanteUser data if one exists
  *
  * @ApiDoc(
  *  description="Returns person data",
  *  uri="/users/{email}/.{_format}",
  *  method="GET",
  *  resource=true,
  *  requirements={
  *       {
  *           "name"="email",
  *           "dataType"="string",
  *           "description"="Email address"
  *       }
  *   },
  *  statusCodes={
  *      200="Returned when successful",
  *      400="Returned when user not found",
  *      403="Returned when the user is not authorized to view diamante users"
  *  }
  * )
  *
  * @param $email
  * @return DiamanteUser
  */
 public function getUser($email)
 {
     $userId = parent::verifyDiamanteUserExists($email);
     if (!$userId) {
         throw new EntityNotFoundException('User not found.');
     }
     return parent::getDiamanteUser(new User($userId, User::TYPE_ORO));
 }
 /**
  * Retrieves DiamanteUser data if one exists
  *
  * @ApiDoc(
  *  description="Returns person data",
  *  uri="/users/{id}.{_format}",
  *  method="GET",
  *  resource=true,
  *  requirements={
  *       {
  *           "name"="id",
  *           "dataType"="integer",
  *           "requirement"="\d+",
  *           "description"="Diamante User Id"
  *       }
  *   },
  *  statusCodes={
  *      200="Returned when successful",
  *      400="Returned when user not found",
  *      403="Returned when the user is not authorized to view diamante users"
  *  }
  * )
  *
  * @param $id
  * @return DiamanteUser
  */
 public function getDiamanteUserById($id)
 {
     $user = parent::getDiamanteUser(new User($id, User::TYPE_DIAMANTE));
     if (!$user) {
         throw new EntityNotFoundException('User not found.');
     }
     return $user;
 }