about summary refs log tree commit diff stats
path: root/crates/rocie-client/README.md
diff options
context:
space:
mode:
authorBenedikt Peetz <benedikt.peetz@b-peetz.de>2026-02-15 22:25:39 +0100
committerBenedikt Peetz <benedikt.peetz@b-peetz.de>2026-02-15 22:25:39 +0100
commitb467f7202f5c0c3970e39ea396a0cec0fd6a36ee (patch)
treeaa567f84f0c2891d03de5b6414507c2d9a5f4754 /crates/rocie-client/README.md
parentfeat(treewide): Add recipes and user handling (diff)
downloadserver-b467f7202f5c0c3970e39ea396a0cec0fd6a36ee.zip
chore(rocie-client): Re-generate the client api
Diffstat (limited to 'crates/rocie-client/README.md')
-rw-r--r--crates/rocie-client/README.md171
1 files changed, 104 insertions, 67 deletions
diff --git a/crates/rocie-client/README.md b/crates/rocie-client/README.md
index 03a4362..fd8ed2b 100644
--- a/crates/rocie-client/README.md
+++ b/crates/rocie-client/README.md
@@ -2,22 +2,19 @@
 
 An enterprise grocery management system - server
 
+
 ## Overview
 
-This API client was generated by the
-[OpenAPI Generator](https://openapi-generator.tech) project. By using the
-[openapi-spec](https://openapis.org) from a remote server, you can easily
-generate an API client.
+This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.  By using the [openapi-spec](https://openapis.org) from a remote server, you can easily generate an API client.
 
 - API version: 0.1.0
 - Package version: 0.1.0
-- Generator version: 7.14.0
+- Generator version: 7.17.0
 - Build package: `org.openapitools.codegen.languages.RustClientCodegen`
 
 ## Installation
 
-Put the package under your project folder in a directory named `rocie-client`
-and add the following to `Cargo.toml` under `[dependencies]`:
+Put the package under your project folder in a directory named `rocie-client` and add the following to `Cargo.toml` under `[dependencies]`:
 
 ```
 rocie-client = { path = "./rocie-client" }
@@ -25,69 +22,108 @@ rocie-client = { path = "./rocie-client" }
 
 ## Documentation for API Endpoints
 
-All URIs are relative to _http://localhost_
-
-| Class                        | Method                                                                                                            | HTTP request                                        | Description                                                            |
-| ---------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------- |
-| _ApiGetAuthInventoryApi_     | [**amount_by_id**](docs/ApiGetAuthInventoryApi.md#amount_by_id)                                                   | **GET** /inventory/{id}                             | Get the amount of an product                                           |
-| _ApiGetAuthProductApi_       | [**product_by_id**](docs/ApiGetAuthProductApi.md#product_by_id)                                                   | **GET** /product/by-id/{id}                         | Get Product by id                                                      |
-| _ApiGetAuthProductApi_       | [**product_by_name**](docs/ApiGetAuthProductApi.md#product_by_name)                                               | **GET** /product/by-name/{name}                     | Get Product by name                                                    |
-| _ApiGetAuthProductApi_       | [**product_suggestion_by_name**](docs/ApiGetAuthProductApi.md#product_suggestion_by_name)                         | **GET** /product/by-part-name/{name}                | Get Product suggestion by name                                         |
-| _ApiGetAuthProductApi_       | [**products_by_product_parent_id_direct**](docs/ApiGetAuthProductApi.md#products_by_product_parent_id_direct)     | **GET** /product/by-product-parent-id-direct/{id}   | Get Products by it's product parent id                                 |
-| _ApiGetAuthProductApi_       | [**products_by_product_parent_id_indirect**](docs/ApiGetAuthProductApi.md#products_by_product_parent_id_indirect) | **GET** /product/by-product-parent-id-indirect/{id} | Get Products by it's product parent id                                 |
-| _ApiGetAuthProductApi_       | [**products_in_storage**](docs/ApiGetAuthProductApi.md#products_in_storage)                                       | **GET** /products_in_storage/                       | Return all products, which non-null amount in storage                  |
-| _ApiGetAuthProductApi_       | [**products_registered**](docs/ApiGetAuthProductApi.md#products_registered)                                       | **GET** /products_registered/                       | Return all registered products                                         |
-| _ApiGetAuthProductParentApi_ | [**product_parents**](docs/ApiGetAuthProductParentApi.md#product_parents)                                         | **GET** /product_parents/                           | Return all registered product parents                                  |
-| _ApiGetAuthProductParentApi_ | [**product_parents_toplevel**](docs/ApiGetAuthProductParentApi.md#product_parents_toplevel)                       | **GET** /product_parents_toplevel/                  | Return all registered product parents, that have no parents themselves |
-| _ApiGetAuthProductParentApi_ | [**product_parents_under**](docs/ApiGetAuthProductParentApi.md#product_parents_under)                             | **GET** /product_parents_under/{id}                 | Return all parents, that have this parent as parent                    |
-| _ApiGetAuthRecipeApi_        | [**recipe_by_id**](docs/ApiGetAuthRecipeApi.md#recipe_by_id)                                                      | **GET** /recipe/by-id/{id}                          | Get an recipe by it's id.                                              |
-| _ApiGetAuthRecipeApi_        | [**recipes**](docs/ApiGetAuthRecipeApi.md#recipes)                                                                | **GET** /recipe/all                                 | Get all added recipes                                                  |
-| _ApiGetAuthUnitApi_          | [**unit_by_id**](docs/ApiGetAuthUnitApi.md#unit_by_id)                                                            | **GET** /unit/{id}                                  | Get Unit by id                                                         |
-| _ApiGetAuthUnitApi_          | [**units**](docs/ApiGetAuthUnitApi.md#units)                                                                      | **GET** /units/                                     | Return all registered units                                            |
-| _ApiGetAuthUnitApi_          | [**units_by_property_id**](docs/ApiGetAuthUnitApi.md#units_by_property_id)                                        | **GET** /units-by-property/{id}                     | Return all registered units for a specific unit property               |
-| _ApiGetAuthUnitPropertyApi_  | [**unit_properties**](docs/ApiGetAuthUnitPropertyApi.md#unit_properties)                                          | **GET** /unit-properties/                           | Return all registered unit properties                                  |
-| _ApiGetAuthUnitPropertyApi_  | [**unit_property_by_id**](docs/ApiGetAuthUnitPropertyApi.md#unit_property_by_id)                                  | **GET** /unit-property/{id}                         | Get Unit property by id                                                |
-| _ApiGetAuthUserApi_          | [**user_by_id**](docs/ApiGetAuthUserApi.md#user_by_id)                                                            | **GET** /user/{id}                                  | Get an specific user by id.                                            |
-| _ApiGetAuthUserApi_          | [**users**](docs/ApiGetAuthUserApi.md#users)                                                                      | **GET** /users                                      | Get all registered users.                                              |
-| _ApiSetAuthBarcodeApi_       | [**buy_barcode**](docs/ApiSetAuthBarcodeApi.md#buy_barcode)                                                       | **POST** /barcode/{barcode_id}/buy/{times}          | Buy an barcode                                                         |
-| _ApiSetAuthBarcodeApi_       | [**consume_barcode**](docs/ApiSetAuthBarcodeApi.md#consume_barcode)                                               | **POST** /barcode/{id}/consume                      | Consume an barcode                                                     |
-| _ApiSetAuthProductApi_       | [**associate_barcode**](docs/ApiSetAuthProductApi.md#associate_barcode)                                           | **POST** /product/{id}/associate                    | Associate a barcode with a product                                     |
-| _ApiSetAuthProductApi_       | [**register_product**](docs/ApiSetAuthProductApi.md#register_product)                                             | **POST** /product/new                               | Register a product                                                     |
-| _ApiSetAuthProductParentApi_ | [**register_product_parent**](docs/ApiSetAuthProductParentApi.md#register_product_parent)                         | **POST** /product_parent/new                        | Register a product parent                                              |
-| _ApiSetAuthRecipeApi_        | [**add_recipe**](docs/ApiSetAuthRecipeApi.md#add_recipe)                                                          | **POST** /recipe/new                                | Register a product parent                                              |
-| _ApiSetAuthUnitApi_          | [**register_unit**](docs/ApiSetAuthUnitApi.md#register_unit)                                                      | **POST** /unit/new                                  | Register an Unit                                                       |
-| _ApiSetAuthUnitPropertyApi_  | [**register_unit_property**](docs/ApiSetAuthUnitPropertyApi.md#register_unit_property)                            | **POST** /unit-property/new                         | Register an Unit Property                                              |
-| _ApiSetAuthUserApi_          | [**register_user**](docs/ApiSetAuthUserApi.md#register_user)                                                      | **POST** /user/new                                  | Register an new User                                                   |
-| _ApiSetNoAuthUserApi_        | [**login**](docs/ApiSetNoAuthUserApi.md#login)                                                                    | **POST** /login                                     | Log in as a specific user                                              |
-| _ApiSetNoAuthUserApi_        | [**logout**](docs/ApiSetNoAuthUserApi.md#logout)                                                                  | **POST** /logout                                    | Log the current user out                                               |
-| _ApiSetNoAuthUserApi_        | [**provision**](docs/ApiSetNoAuthUserApi.md#provision)                                                            | **POST** /provision                                 | Provision this instance.                                               |
+All URIs are relative to *http://localhost*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*ApiGetAuthInventoryApi* | [**amount_by_id**](docs/ApiGetAuthInventoryApi.md#amount_by_id) | **GET** /inventory/{id} | Get the amount of an product
+*ApiGetAuthProductApi* | [**product_by_id**](docs/ApiGetAuthProductApi.md#product_by_id) | **GET** /product/by-id/{id} | Get Product by id
+*ApiGetAuthProductApi* | [**product_by_name**](docs/ApiGetAuthProductApi.md#product_by_name) | **GET** /product/by-name/{name} | Get Product by name
+*ApiGetAuthProductApi* | [**product_suggestion_by_name**](docs/ApiGetAuthProductApi.md#product_suggestion_by_name) | **GET** /product/by-part-name/{name} | Get Product suggestion by name
+*ApiGetAuthProductApi* | [**products_by_product_parent_id_direct**](docs/ApiGetAuthProductApi.md#products_by_product_parent_id_direct) | **GET** /product/by-product-parent-id-direct/{id} | Get Products by it's product parent id
+*ApiGetAuthProductApi* | [**products_by_product_parent_id_indirect**](docs/ApiGetAuthProductApi.md#products_by_product_parent_id_indirect) | **GET** /product/by-product-parent-id-indirect/{id} | Get Products by it's product parent id
+*ApiGetAuthProductApi* | [**products_in_storage**](docs/ApiGetAuthProductApi.md#products_in_storage) | **GET** /products_in_storage/ | Return all products, which non-null amount in storage
+*ApiGetAuthProductApi* | [**products_registered**](docs/ApiGetAuthProductApi.md#products_registered) | **GET** /products_registered/ | Return all registered products
+*ApiGetAuthProductApi* | [**products_without_product_parent**](docs/ApiGetAuthProductApi.md#products_without_product_parent) | **GET** /product/without-product-parent | Get Products by it's absents of a product parent
+*ApiGetAuthProductParentApi* | [**product_parents**](docs/ApiGetAuthProductParentApi.md#product_parents) | **GET** /product_parents/ | Return all registered product parents
+*ApiGetAuthProductParentApi* | [**product_parents_toplevel**](docs/ApiGetAuthProductParentApi.md#product_parents_toplevel) | **GET** /product_parents_toplevel/ | Return all registered product parents, that have no parents themselves
+*ApiGetAuthProductParentApi* | [**product_parents_under**](docs/ApiGetAuthProductParentApi.md#product_parents_under) | **GET** /product_parents_under/{id} | Return all parents, that have this parent as parent
+*ApiGetAuthRecipeApi* | [**recipe_by_id**](docs/ApiGetAuthRecipeApi.md#recipe_by_id) | **GET** /recipe/by-id/{id} | Get an recipe by it's id.
+*ApiGetAuthRecipeApi* | [**recipe_by_name**](docs/ApiGetAuthRecipeApi.md#recipe_by_name) | **GET** /recipe/by-name/{name} | Get an recipe by it's name.
+*ApiGetAuthRecipeApi* | [**recipes**](docs/ApiGetAuthRecipeApi.md#recipes) | **GET** /recipe/all | Get all added recipes
+*ApiGetAuthRecipeApi* | [**recipes_by_recipe_parent_id_direct**](docs/ApiGetAuthRecipeApi.md#recipes_by_recipe_parent_id_direct) | **GET** /recipe/by-recipe-parent-id-direct/{id} | Get Recipes by it's recipe parent id
+*ApiGetAuthRecipeApi* | [**recipes_by_recipe_parent_id_indirect**](docs/ApiGetAuthRecipeApi.md#recipes_by_recipe_parent_id_indirect) | **GET** /recipe/by-recipe-parent-id-indirect/{id} | Get Recipes by it's recipe parent id
+*ApiGetAuthRecipeApi* | [**recipes_without_recipe_parent**](docs/ApiGetAuthRecipeApi.md#recipes_without_recipe_parent) | **GET** /recipe/without-recipe-parent | Get Recipes by it's absents of a recipe parent
+*ApiGetAuthRecipeParentApi* | [**recipe_parents**](docs/ApiGetAuthRecipeParentApi.md#recipe_parents) | **GET** /recipe_parents/ | Return all registered recipe parents
+*ApiGetAuthRecipeParentApi* | [**recipe_parents_toplevel**](docs/ApiGetAuthRecipeParentApi.md#recipe_parents_toplevel) | **GET** /recipe_parents_toplevel/ | Return all registered recipe parents, that have no parents themselves
+*ApiGetAuthRecipeParentApi* | [**recipe_parents_under**](docs/ApiGetAuthRecipeParentApi.md#recipe_parents_under) | **GET** /recipe_parents_under/{id} | Return all parents, that have this parent as parent
+*ApiGetAuthUnitApi* | [**unit_by_id**](docs/ApiGetAuthUnitApi.md#unit_by_id) | **GET** /unit/{id} | Get Unit by id
+*ApiGetAuthUnitApi* | [**units**](docs/ApiGetAuthUnitApi.md#units) | **GET** /units/ | Return all registered units
+*ApiGetAuthUnitApi* | [**units_by_property_id**](docs/ApiGetAuthUnitApi.md#units_by_property_id) | **GET** /units-by-property/{id} | Return all registered units for a specific unit property
+*ApiGetAuthUnitPropertyApi* | [**unit_properties**](docs/ApiGetAuthUnitPropertyApi.md#unit_properties) | **GET** /unit-properties/ | Return all registered unit properties
+*ApiGetAuthUnitPropertyApi* | [**unit_property_by_id**](docs/ApiGetAuthUnitPropertyApi.md#unit_property_by_id) | **GET** /unit-property/{id} | Get Unit property by id
+*ApiGetAuthUserApi* | [**user_by_id**](docs/ApiGetAuthUserApi.md#user_by_id) | **GET** /user/{id} | Get an specific user by id.
+*ApiGetAuthUserApi* | [**users**](docs/ApiGetAuthUserApi.md#users) | **GET** /users | Get all registered users.
+*ApiGetNoAuthStateApi* | [**can_be_provisioned**](docs/ApiGetNoAuthStateApi.md#can_be_provisioned) | **GET** /can-be-provisioned | Check if the server can be provisioned
+*ApiGetNoAuthStateApi* | [**is_logged_in**](docs/ApiGetNoAuthStateApi.md#is_logged_in) | **GET** /is-logged-in | Check if you are logged in
+*ApiSetAuthBarcodeApi* | [**buy_barcode**](docs/ApiSetAuthBarcodeApi.md#buy_barcode) | **POST** /barcode/{barcode_id}/buy/{times} | Buy an barcode
+*ApiSetAuthBarcodeApi* | [**consume_barcode**](docs/ApiSetAuthBarcodeApi.md#consume_barcode) | **POST** /barcode/{id}/consume | Consume an barcode
+*ApiSetAuthProductApi* | [**associate_barcode**](docs/ApiSetAuthProductApi.md#associate_barcode) | **POST** /product/{id}/associate | Associate a barcode with a product
+*ApiSetAuthProductApi* | [**register_product**](docs/ApiSetAuthProductApi.md#register_product) | **POST** /product/new | Register a product
+*ApiSetAuthProductParentApi* | [**register_product_parent**](docs/ApiSetAuthProductParentApi.md#register_product_parent) | **POST** /product_parent/new | Register a product parent
+*ApiSetAuthRecipeApi* | [**add_recipe**](docs/ApiSetAuthRecipeApi.md#add_recipe) | **POST** /recipe/new | Register a product parent
+*ApiSetAuthRecipeParentApi* | [**register_recipe_parent**](docs/ApiSetAuthRecipeParentApi.md#register_recipe_parent) | **POST** /recipe_parent/new | Register a product parent
+*ApiSetAuthUnitApi* | [**register_unit**](docs/ApiSetAuthUnitApi.md#register_unit) | **POST** /unit/new | Register an Unit
+*ApiSetAuthUnitPropertyApi* | [**register_unit_property**](docs/ApiSetAuthUnitPropertyApi.md#register_unit_property) | **POST** /unit-property/new | Register an Unit Property
+*ApiSetAuthUserApi* | [**register_user**](docs/ApiSetAuthUserApi.md#register_user) | **POST** /user/new | Register an new User
+*ApiSetNoAuthUserApi* | [**login**](docs/ApiSetNoAuthUserApi.md#login) | **POST** /login | Log in as a specific user
+*ApiSetNoAuthUserApi* | [**logout**](docs/ApiSetNoAuthUserApi.md#logout) | **POST** /logout | Log the current user out
+*ApiSetNoAuthUserApi* | [**provision**](docs/ApiSetNoAuthUserApi.md#provision) | **POST** /provision | Provision this instance.
+
 
 ## Documentation For Models
 
-- [Barcode](docs/Barcode.md)
-- [BarcodeId](docs/BarcodeId.md)
-- [LoginInfo](docs/LoginInfo.md)
-- [PasswordHash](docs/PasswordHash.md)
-- [Product](docs/Product.md)
-- [ProductAmount](docs/ProductAmount.md)
-- [ProductId](docs/ProductId.md)
-- [ProductParent](docs/ProductParent.md)
-- [ProductParentId](docs/ProductParentId.md)
-- [ProductParentStub](docs/ProductParentStub.md)
-- [ProductStub](docs/ProductStub.md)
-- [Recipe](docs/Recipe.md)
-- [RecipeId](docs/RecipeId.md)
-- [RecipeStub](docs/RecipeStub.md)
-- [Unit](docs/Unit.md)
-- [UnitAmount](docs/UnitAmount.md)
-- [UnitId](docs/UnitId.md)
-- [UnitProperty](docs/UnitProperty.md)
-- [UnitPropertyId](docs/UnitPropertyId.md)
-- [UnitPropertyStub](docs/UnitPropertyStub.md)
-- [UnitStub](docs/UnitStub.md)
-- [User](docs/User.md)
-- [UserId](docs/UserId.md)
-- [UserStub](docs/UserStub.md)
+ - [Barcode](docs/Barcode.md)
+ - [BarcodeId](docs/BarcodeId.md)
+ - [Content](docs/Content.md)
+ - [ContentOneOf](docs/ContentOneOf.md)
+ - [ContentOneOf1](docs/ContentOneOf1.md)
+ - [CooklangRecipe](docs/CooklangRecipe.md)
+ - [Cookware](docs/Cookware.md)
+ - [Ingredient](docs/Ingredient.md)
+ - [IngredientOneOf](docs/IngredientOneOf.md)
+ - [IngredientOneOf1](docs/IngredientOneOf1.md)
+ - [IngredientOneOf1NotRegisteredProduct](docs/IngredientOneOf1NotRegisteredProduct.md)
+ - [IngredientOneOf2](docs/IngredientOneOf2.md)
+ - [IngredientOneOf2RecipeReference](docs/IngredientOneOf2RecipeReference.md)
+ - [IngredientOneOfRegisteredProduct](docs/IngredientOneOfRegisteredProduct.md)
+ - [Item](docs/Item.md)
+ - [ItemOneOf](docs/ItemOneOf.md)
+ - [ItemOneOf1](docs/ItemOneOf1.md)
+ - [ItemOneOf2](docs/ItemOneOf2.md)
+ - [ItemOneOf3](docs/ItemOneOf3.md)
+ - [ItemOneOf4](docs/ItemOneOf4.md)
+ - [LoginInfo](docs/LoginInfo.md)
+ - [Metadata](docs/Metadata.md)
+ - [NameAndUrl](docs/NameAndUrl.md)
+ - [PasswordHash](docs/PasswordHash.md)
+ - [Product](docs/Product.md)
+ - [ProductAmount](docs/ProductAmount.md)
+ - [ProductId](docs/ProductId.md)
+ - [ProductParent](docs/ProductParent.md)
+ - [ProductParentId](docs/ProductParentId.md)
+ - [ProductParentStub](docs/ProductParentStub.md)
+ - [ProductStub](docs/ProductStub.md)
+ - [Recipe](docs/Recipe.md)
+ - [RecipeId](docs/RecipeId.md)
+ - [RecipeParent](docs/RecipeParent.md)
+ - [RecipeParentId](docs/RecipeParentId.md)
+ - [RecipeParentStub](docs/RecipeParentStub.md)
+ - [RecipeStub](docs/RecipeStub.md)
+ - [Section](docs/Section.md)
+ - [Step](docs/Step.md)
+ - [Timer](docs/Timer.md)
+ - [Unit](docs/Unit.md)
+ - [UnitAmount](docs/UnitAmount.md)
+ - [UnitId](docs/UnitId.md)
+ - [UnitProperty](docs/UnitProperty.md)
+ - [UnitPropertyId](docs/UnitPropertyId.md)
+ - [UnitPropertyStub](docs/UnitPropertyStub.md)
+ - [UnitStub](docs/UnitStub.md)
+ - [User](docs/User.md)
+ - [UserId](docs/UserId.md)
+ - [UserStub](docs/UserStub.md)
+
 
 To get access to the crate's generated documentation, use:
 
@@ -98,3 +134,4 @@ cargo doc --open
 ## Author
 
 benedikt.peetz@b-peetz.de
+