title: REST API - GetUserByEmail best approach for get route
body: <p>I am trying to follow a pattern with my api routes. </p>
  
  <p>These are all GET requests</p>
  
  <pre><code>/users                         -- get all users
  /users/{userId}                -- get user by id
  /users/email/{email}           -- get user by email
  </code></pre>
  
  <p>Obv. that third one is a problem since the last part of the route will have something like /user@domain.com, thus the route is not processed since it thinks I am trying to go to a different domain (ex:  <code>http://localhost/users/email/me@microsoft.com</code></p>
  
  <p>I know that I can make this work with a POST, I know I can make this work with some other combination like /users/{email}/gedderdone</p>
  
  <p>... but I am trying to follow a pattern that is consistent for all resources.</p>
  
  <p>ie:</p>
  
  <pre><code>/people/{id}
  /people/name/{name}
  /people/ssn/{ssn}
  </code></pre>
  
  <p>How should I format the REST endpoint for getting a user by their email address?  I do want to use a GET as I am 'getting' the user. </p>
  
  <p>Thanks :-)  </p>