Split the `/security/token` endpoint into two separate endpoints

[alexmerlin]

Bug Report

Running the OpenAPI docs generator command:

./vendor/bin/openapi ./src --output public/openapi.yaml --version 3.1.0

we see the following output:

Warning: Unable to merge @OA\Post() in /var/www/api.dotkernel.localhost/html/src/Security/src/OpenAPI.php on line 116

This happens because both the generate and refresh token endpoints have the same URL (POST /security/token).

In order to fix this we must revert to using the pre-6.0 URLs, where both endpoints had their own unique URL:

• POST /security/generate-token
• POST /security/refresh-token

The endpoints themselves don't have to be the exact same ones we used on branch 5.0, they just need to be different.

Q	A
Version(s)	6.x

[alexmerlin]

See below the how the endpoints would look after this modification:

Source:

Module	Verb	Resource	Extra	Handler	Handler path	Route path	Route name
Admin	Get	AdminAccount	Resource	Handler	src/Admin/src/Handler/Account/GetAdminAccountResourceHandler.php	/admin/account	admin::view-account
Admin	Patch	AdminAccount	Resource	Handler	src/Admin/src/Handler/Account/PatchAdminAccountResourceHandler.php	/admin/account	admin::update-account
Admin	Get	Admin	Collection	Handler	src/Admin/src/Handler/Admin/GetAdminCollectionHandler.php	/admin	admin::list-admin
Admin	Post	Admin	Resource	Handler	src/Admin/src/Handler/Admin/PostAdminResourceHandler.php	/admin	admin::create-admin
Admin	Delete	Admin	Resource	Handler	src/Admin/src/Handler/Admin/DeleteAdminResourceHandler.php	/admin/{uuid}	admin::delete-admin
Admin	Get	Admin	Resource	Handler	src/Admin/src/Handler/Admin/GetAdminResourceHandler.php	/admin/{uuid}	admin::view-admin
Admin	Patch	Admin	Resource	Handler	src/Admin/src/Handler/Admin/PatchAdminResourceHandler.php	/admin/{uuid}	admin::update-admin
Admin	Get	AdminRole	Collection	Handler	src/Admin/src/Handler/Admin/Role/GetAdminRoleCollectionHandler.php	/admin/role	admin::list-role
Admin	Get	AdminRole	Resource	Handler	src/Admin/src/Handler/Admin/Role/GetAdminRoleResourceHandler.php	/admin/role/{uuid}	admin::view-role
App	Get	Index	Resource	Handler	src/App/src/Handler/GetIndexResourceHandler.php	/	app::view-index
App	Post	ErrorReport	Resource	Handler	src/App/src/Handler/PostErrorReportResourceHandler.php	/error-report	app::create-error-report
Security	Post	Token	Generate	Handler	vendor/mezzio/mezzio-authentication-oauth2/src/TokenEndpointHandler.php	/security/generate-token	security::generate-token
Security	Post	Token	Refresh	Handler	vendor/mezzio/mezzio-authentication-oauth2/src/TokenEndpointHandler.php	/security/refresh-token	security::refresh-token
User	Get	User	Collection	Handler	src/User/src/Handler/User/GetUserCollectionHandler.php	/user	user::list-user
User	Post	User	Resource	Handler	src/User/src/Handler/User/PostUserResourceHandler.php	/user	user::create-user
User	Delete	User	Resource	Handler	src/User/src/Handler/User/DeleteUserResourceHandler.php	/user/{uuid}	user::delete-user
User	Get	User	Resource	Handler	src/User/src/Handler/User/GetUserResourceHandler.php	/user/{uuid}	user::view-user
User	Patch	User	Resource	Handler	src/User/src/Handler/User/PatchUserResourceHandler.php	/user/{uuid}	user::update-user
User	Patch	User	Activate	Handler	src/User/src/Handler/User/PatchUserActivateHandler.php	/user/{uuid}/activate	user::activate-user
User	Patch	User	Deactivate	Handler	src/User/src/Handler/User/PatchUserDeactivateHandler.php	/user/{uuid}/deactivate	user::deactivate-user
User	Delete	UserAvatar	Resource	Handler	src/User/src/Handler/User/Avatar/DeleteUserAvatarResourceHandler.php	/user/{uuid}/avatar	user::delete-user-avatar
User	Get	UserAvatar	Resource	Handler	src/User/src/Handler/User/Avatar/GetUserAvatarResourceHandler.php	/user/{uuid}/avatar	user::view-user-avatar
User	Post	UserAvatar	Resource	Handler	src/User/src/Handler/User/Avatar/PostUserAvatarResourceHandler.php	/user/{uuid}/avatar	user::create-user-avatar
User	Get	UserRole	Collection	Handler	src/User/src/Handler/User/Role/GetUserRoleCollectionHandler.php	/user/role	user::list-role
User	Get	UserRole	Resource	Handler	src/User/src/Handler/User/Role/GetUserRoleResourceHandler.php	/user/role/{uuid}	user::view-role
User	Delete	UserAccount	Resource	Handler	src/User/src/Handler/Account/DeleteUserAccountResourceHandler.php	/user/account	user::delete-account
User	Patch	UserAccount	Resource	Handler	src/User/src/Handler/Account/PatchUserAccountResourceHandler.php	/user/account	user::update-account
User	Post	UserAccount	Resource	Handler	src/User/src/Handler/Account/PostUserAccountResourceHandler.php	/user/account	user::create-account
User	Get	UserAccount	Resource	Handler	src/User/src/Handler/Account/GetUserAccountResourceHandler.php	/user/account	user::view-account
User	Post	UserAccount	Recover	Handler	src/User/src/Handler/Account/PostUserAccountRecoverHandler.php	/user/account/recover	user::recover-account
User	Post	UserAccount	Activate	Handler	src/User/src/Handler/Account/PostUserAccountActivateHandler.php	/user/account/activate	user::request-activate-account
User	Patch	UserAccount	Activate	Handler	src/User/src/Handler/Account/PatchUserAccountActivateHandler.php	/user/account/activate/{hash}	user::activate-account
User	Delete	UserAccountAvatar	Resource	Handler	src/User/src/Handler/Account/Avatar/DeleteUserAccountAvatarResourceHandler.php	/user/account/avatar	user::delete-account-avatar
User	Get	UserAccountAvatar	Resource	Handler	src/User/src/Handler/Account/Avatar/GetUserAccountAvatarResourceHandler.php	/user/account/avatar	user::view-account-avatar
User	Post	UserAccountAvatar	Resource	Handler	src/User/src/Handler/Account/Avatar/PostUserAccountAvatarResourceHandler.php	/user/account/avatar	user::create-account-avatar
User	Get	UserAccountResetPassword	Resource	Handler	src/User/src/Handler/Account/ResetPassword/GetUserAccountResetPasswordResourceHandler.php	/user/account/reset-password/{hash}	user::check-account-reset-password
User	Patch	UserAccountResetPassword	Resource	Handler	src/User/src/Handler/Account/ResetPassword/PatchUserAccountResetPasswordResourceHandler.php	/user/account/reset-password/{hash}	user::update-account-reset-password
User	Post	UserAccountResetPassword	Resource	Handler	src/User/src/Handler/Account/ResetPassword/PostUserAccountResetPasswordResourceHandler.php	/user/account/reset-password	user::create-account-reset-password

[alexmerlin]

Implemented in #423