After some internal discussions

It's not straight, but most of the people of this world use a not-straight-"best practice". Yeah :-/

src/v2/README.md

@@ -25,13 +25,17 @@ Each trader has it's own domain or a generated one by us. The base-URI could be:
 
 # Methods
 
-With each call you'll interact with ressources. The verb you do will be the HTTP method.
+With each call you'll interact with ressources. We follow typical best practices in HTTP method and URI namings.
-- GET /api/core/users -> Retrieve all customers
+- GET /api/tyrepro/users -> Retrieve all customers
-- GET /api/core/users/1 -> Retrieve data of customer 1
+- GET /api/tyrepro/users/1 -> Retrieve data of customer 1
-- GET /api/core/users/1/permissions -> Retrieve all permissions of customer 1
+- GET /api/tyrepro/users/1/permissions -> Retrieve all permissions of customer 1
-- DELETE /api/core/users/1 -> Delete customer 1
+- POST /api/tyrepro/users -> Create a customer
-- BAN /api/core/users/1 -> Ban customer 1
+- PATCH /api/tyrepro/users/1 -> Modify some data of customer 1
-- NOTIFY-GTC-VIOLANCE /api/core/users/1 -> Notifies customer 1 for a violation of the terms and conditions
+- DELETE /api/tyrepro/users/1 -> Delete customer 1
+
+To apply non-CRUD-methods to a ressource, we allways use HTTP-POST-methods.
+- POST /api/tyrepro/users/1/ban -> Ban customer 1
+- POST /api/tyrepro/users/1/notify-gtc-violance -> Notifies customer 1 for a violation of the terms and conditions
 
 # Authentication
 
@@ -46,18 +50,3 @@ With each call you'll interact with ressources. The verb you do will be the HTTP
 # Response Resolution
 
 # Caching
-
-
-
-
-
-## TODO
-
-GET /api/shop/vehicles
-GET /api/tyrepro/vehicles
-GET /api/tiretask/vehicles
-GET /api/openitem/vehicles
-GET /api/rdks/vehicles
-
-GET /api/vehicles/shopview
-GET /api/vehicles/tyreproview