/v3/auth/tokens vs /v3/auth/token

[Dolph Mathews]

The Identity API v3 spec conflicts with the server-side implementation regarding the path used for token authentication. I'm not sure which is intended to be correct, and which is a mistake.

  /v3/auth/token (spec)
  /v3/auth/tokens (implementation)

[Guang Yee (guang-yee)]

I prefer /v3/auth/tokens for two reasons

1. consistent with other resources. i.e. /v3/users
2. we may actually be returning multiple tokens in the near future for multiple scoping purposes

[Dolph Mathews (dolph)]

Proposed fix to identity-api based on (1) in: https://review.openstack.org/#/c/23831/

on 2: that would be backwards-incompatible with the current API on several points (X-Subject-Token; single entity in response body at least)