style(endpoints): Use /item and /store instead of plural

Author: jslvtr

docs/docs/01_course_intro/04_what_is_rest_api/README.md

@@ -147,33 +147,33 @@ We'll deal with user authentication in a later section, but that's what the lock
 
 ### Stores
 
-| Method | Endpoint       | Description                              |
-| ------ | -------------- | ---------------------------------------- |
-| `GET`  | `/stores`      | Get a list of all stores.                |
-| `POST` | `/stores`      | Create a store.                          |
-| `GET`  | `/stores/{id}` | Get a single store, given its unique id. |
-| `POST` | `/stores/{id}` | Delete a store, given its unique id.     |
+| Method | Endpoint      | Description                              |
+| ------ | ------------- | ---------------------------------------- |
+| `GET`  | `/store`      | Get a list of all stores.                |
+| `POST` | `/store`      | Create a store.                          |
+| `GET`  | `/store/{id}` | Get a single store, given its unique id. |
+| `POST` | `/store/{id}` | Delete a store, given its unique id.     |
 
 ### Items
 
-| Method           | Endpoint      | Description                                                                                         |
-| ---------------- | ------------- | --------------------------------------------------------------------------------------------------- |
-| 🔒 <br/> `GET`    | `/items`      | Get a list of all items in all stores.                                                              |
-| 🔒🔒 <br/> `POST`  | `/items`      | Create a new item, given its name and price in the body of the request.                             |
-| 🔒 <br/> `GET`    | `/items/{id}` | Get information about a specific item, given its unique id.                                         |
-| `PUT`            | `/items/{id}` | Update an item given its unique id. The item name or price can be given in the body of the request. |
-| 🔒 <br/> `DELETE` | `/items/{id}` | Delete an item given its unique id.                                                                 |
+| Method           | Endpoint     | Description                                                                                         |
+| ---------------- | ------------ | --------------------------------------------------------------------------------------------------- |
+| 🔒 <br/> `GET`    | `/item`      | Get a list of all items in all stores.                                                              |
+| 🔒🔒 <br/> `POST`  | `/item`      | Create a new item, given its name and price in the body of the request.                             |
+| 🔒 <br/> `GET`    | `/item/{id}` | Get information about a specific item, given its unique id.                                         |
+| `PUT`            | `/item/{id}` | Update an item given its unique id. The item name or price can be given in the body of the request. |
+| 🔒 <br/> `DELETE` | `/item/{id}` | Delete an item given its unique id.                                                                 |
 
 ### Tags
 
-| Method   | Endpoint                | Description                                             |
-| -------- | ----------------------- | ------------------------------------------------------- |
-| `GET`    | `/stores/{id}/tags`     | Get a list of tags in a store.                          |
-| `POST`   | `/stores/{id}/tags`     | Create a new tag.                                       |
-| `POST`   | `/items/{id}/tags/{id}` | Link an item in a store with a tag from the same store. |
-| `DELETE` | `/items/{id}/tags/{id}` | Unlink a tag from an item.                              |
-| `GET`    | `/tags/{id}`            | Get information about a tag given its unique id.        |
-| `DELETE` | `/tags/{id}`            | Delete a tag, which must have no associated items.      |
+| Method   | Endpoint              | Description                                             |
+| -------- | --------------------- | ------------------------------------------------------- |
+| `GET`    | `/store/{id}/tag`     | Get a list of tags in a store.                          |
+| `POST`   | `/store/{id}/tag`     | Create a new tag.                                       |
+| `POST`   | `/item/{id}/tag/{id}` | Link an item in a store with a tag from the same store. |
+| `DELETE` | `/item/{id}/tag/{id}` | Unlink a tag from an item.                              |
+| `GET`    | `/tag/{id}`           | Get information about a tag given its unique id.        |
+| `DELETE` | `/tag/{id}`           | Delete a tag, which must have no associated items.      |
 
 As you can see, we've got a lot to build!
 

docs/docs/03_first_rest_api/05_make_request_to_rest_api/README.md

@@ -37,7 +37,7 @@ Then, create a new Request Collection. Call it "Stores REST API".
 In the Request Collection, we can now add requests! Each request has a few parts:
 
 - A **method**, such as `GET` or `POST`. The method is just a piece of data sent to the server, but _usually_ certain methods are used for certain things.
-- The **URL** that you want to request. For our API, this is formed of the "Base URL" (for Flask apps, that's `http://127.0.0.1:5000`), and the endpoint (e.g. `/stores`).
+- The **URL** that you want to request. For our API, this is formed of the "Base URL" (for Flask apps, that's `http://127.0.0.1:5000`), and the endpoint (e.g. `/store`).
 - The **body**, or any data that you want to send in the request. For example, when creating stores or items we might send some data.
 - The **headers**, which are other pieces of data with specific names, that the server can use. For example, a header might be sent to help the server understand _who_ is making the request.
 

docs/docs/03_first_rest_api/07_creating_items/README.md

@@ -80,7 +80,7 @@ def create_store():
 
 # highlight-start
 @app.post("/store/<string:name>/item")
-def create_item_in_store(name):
+def create_item(name):
     request_data = request.get_json()
     for store in stores:
         if store["name"] == name:

docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/end/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/end/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/start/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/start/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/end/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/end/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/start/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/start/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/start/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/start/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -24,7 +24,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/resources/store.py

@@ -10,7 +10,7 @@
 blp = Blueprint("Stores", "stores", description="Operations on stores")
 
 
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):
@@ -20,7 +20,7 @@ def delete(self, store_id):
         raise NotImplementedError("Deleting a store is not implemented.")
 
 
-@blp.route("/stores")
+@blp.route("/store")
 class StoreList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):

docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/README.md

@@ -31,7 +31,7 @@ We're going to use `.get_or_404()` repeatedly in our resources!
 For now, and since we'll need an `ItemModel` instance in all our `Item` resource methods, let's add that:
 
 ```python title="resources/item.py"
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -58,7 +58,7 @@ class Item(MethodView):
 Similarly in our `Store` resource:
 
 ```python title="resources/store.py"
-@blp.route("/stores/<string:store_id>")
+@blp.route("/store/<string:store_id>")
 class Store(MethodView):
     @blp.response(200, StoreSchema)
     def get(self, store_id):

docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/resources/item.py

@@ -9,7 +9,7 @@
 blp = Blueprint("Items", "items", description="Operations on items")
 
 
-@blp.route("/items/<string:item_id>")
+@blp.route("/item/<string:item_id>")
 class Item(MethodView):
     @blp.response(200, ItemSchema)
     def get(self, item_id):
@@ -28,7 +28,7 @@ def put(self, item_data, item_id):
         raise NotImplementedError("Updating an item is not implemented.")
 
 
-@blp.route("/items")
+@blp.route("/item")
 class ItemList(MethodView):
     @blp.response(200, ItemSchema(many=True))
     def get(self):