Welcome to Bangazon! The new virtual marketplace. This marketplace allows customers to buy and sell products through a single page application web page built in React. The application's data is tracked through a powerful, hand-crafted API built in C#/ADO.Net.
Before beginning please follow these steps:
-
Navigate your host file
-
Windows - SystemRoot > system32 > drivers > etc > hosts By default the system root is C:\Windows, so if you are using Windows, your hosts file is most probably: C:\Windows\System32\drivers\etc\hosts)
-
Linux - /etc/hosts
-
Mac OS X - /private/etc/hosts
at the end of your host file insert your IP address followed by : bangazon.com
Sql Server Manangment Studio Visual Studio Community 2017 Google Chrome
Start the program by cd'ing into the BangazonAPI and using the command dotnet run. Once the program is running, open up the Postman desktop app and run the following commands:
-
select GET then paste localhost:5000/customer into the field and click send. The result should be an array of all the customers in the database.
-
select GET then paste http://localhost:5000/customer?_include=payments into the field and click send. The result should be an array of all the customers in the database with all of the payment types included in that customers as well.
-
select GET then paste http://localhost:5000/customer?_include=products into the field and click send. The result should be an array of all the customers in the database with all of the products types included in that customers as well.
-
select GET then paste http://localhost:5000/customer?q=sat into the field and click send. The result should be an array of all the customers in the database with first or last names that contains sat.
-
select GET then paste localhost:5000/customer/1 or any other number that showed up in the previous query as CustomerId and click send. The result should be only that object of the specified Customer
select POST, then paste localhost:5000/customer into the field, then click Body underneath the field, then select raw, and then paste this snippet or make one similar
{
"FirstName": "Test",
"LastName": "Customer"
}
then click send. The result should be the new customer you made.
select PUT then paste localhost:5000/customer/1 or any other Customer Id , then click Body underneath the field, then select raw, and then paste this snippet or make one similar
"FirstName": "Test",
"LastName": "Instructions"
}
You should get nothing back from this. When you run the GET query the Customer you specified in your PUT query should show the updated, edited information you gave it.
Use the command dotnet run to start the program, BangazonAPI. Once the program is running, open up the Postman desktop app and run the following commands for each request method:
To GET all Departments, select GET in Postman then paste localhost:5000/department into the field and click send. The result should be an array of all the Departments in the database.
-
select GET then paste http://localhost:5000/department?_include=employee into the field and click send. The result should be an array of all the department in the database with all of the products included in that department as well.
-
To GET a specific, single Department, add an /{id} to the end of the localhost:5000/department URL. The result should only include the single department with the Id you added.
To POST a new object to your existing array for Department, select POST, then paste localhost:5000/department into the field. Then click Body underneath the field, select raw, and then paste this below snippet or make one similar then click send. The result should be the new Department you made:
{
"DepartmentName": "Test",
"ExpenseBudget": "300000"
}
To update an existing Department, select PUT then paste localhost:5000/Department/2 or any other existing department. Then follow the same directions as the POST example, and change the values then click send:
{
"DepartmentName":"NewDepartmentName",
"ExpenseBudget":"234234"
}
Use the command dotnet run to start the program, BangazonAPI. Once the program is running, open up the Postman desktop app and run the following commands for each request method:
To GET all employees, select GET in Postman then paste localhost:5000/employee into the field and click send. The result should be an array of all the Employees in the database.
- To GET a specific, single order, add an /{id} to the end of the localhost:5000/employee URL. The result should only include the single employee with the Id you added.
To POST a new object to your existing array for Employee, select POST, then paste localhost:5000/employee into the field. Then click Body underneath the field, select raw, and then paste this below snippet or make one similar then click send. The result should be the new Employee you made.
To update an existing employee, select PUT then paste localhost:5000/employee/2 or any other existing employee. Then follow the same directions as the POST example, and change the values then click send:
{
"employeeId": 2,
"FirstName": "Jack",
"LastName": "Bob",
"IsSupervisor": false,
"DepartmentId": 2,
}
You should get nothing back from this besides an OK status. When you run the GET query the employee you specified in your PUT query should show the updated, edited information you gave it.
Use the command dotnet run to start the program, BangazonAPI. Once the program is running, open up the Postman desktop app and run the following commands for each request method:
To GET all products, select GET in Postman then paste localhost:5000/product into the field and click send. The result should be an array of all the Products in the database.
- To GET a specific product, add an /{id} to the end of the localhost:5000/product URL. The result should only include the single product with the Id you added.
To POST a new object to your existing array for Product, select POST, then paste localhost:5000/product into the field. Then click Body underneath the field, select raw, and then paste this below snippet or make one similar then click send. The result should be the new Product you made.
{
"productTypeId": 1,
"title": "Computer",
"price": 2000,
"description": "Dell XPS 13",
"quantity": 1,
"customerId": 1
}
To update an existing product, select PUT then paste localhost:5000/product/2 or any other existing product. Then follow the same directions as the POST example, and change the values then click send:
{
"productTypeId": 2,
"title": "Baseball Bat",
"price": 5,
"description": "Metal",
"quantity": 1,
"customerId": 2
}
You should get nothing back from this besides an OK status. When you run the GET query the product you specified in your PUT query should show the updated, edited information you gave it.
To delete an existing product, select DELETE then paste localhost:5000/product/2 or any other existing product that you wish to delete. Click send and you should get back an OK status which will indicate that the product has been deleted from the database.
Use the command dotnet run to start the program, BangazonAPI. Once the program is running, open up the Postman desktop app and run the following commands for each request method:
To GET all types of products, select GET in Postman then paste localhost:5000/producttype into the field and click send. The result should be an array of all the Product Types in the database.
- To GET a specific type of product, add an /{id} to the end of the localhost:5000/producttype URL. The result should only include the single product type with the Id you added.
To POST a new object to your existing array for Product Type, select POST, then paste localhost:5000/producttype into the field. Then click Body underneath the field, select raw, and then paste this below snippet or make one similar then click send. The result should be the new Product Type you made.
{
"name": "Clothes",
}
To update an existing product type, select PUT then paste localhost:5000/producttype/2 or any other existing product type. Then follow the same directions as the POST example, and change the values then click send:
{
"name": "Sports and Outdoors Equipment",
}
You should get nothing back from this besides an OK status. When you run the GET query the product type you specified in your PUT query should show the updated, edited information you gave it.
To delete an existing product type, select DELETE then paste localhost:5000/producttype/2 or any other existing product type that you wish to delete. Click send and you should get back an OK status which will indicate that the product type has been deleted from the database.
Use the command dotnet run to start the program, BangazonAPI. Once the program is running, open up the Postman desktop app and run the following commands for each request method:
To GET all computers, select GET in Postman then paste localhost:5000/computer into the field and click send. The result should be an array of all the Computers in the database.
- To GET a specific computer, add an /{id} to the end of the localhost:5000/computer URL. The result should only include the single computer with the Id you added.
To POST a new object to your existing array for Computer, select POST, then paste localhost:5000/computer into the field. Then click Body underneath the field, select raw, and then paste this below snippet or make one similar then click send. The result should be the new Computer you made.
{
"purchaseDate": "2019-01-01T00:00:00",
"make": "XPS 13",
"manufacturer": "Dell"
}
To update an existing computer, select PUT then paste localhost:5000/computer/1 or any other existing computer. Then follow the same directions as the POST example, and change the values then click send:
{
"purchaseDate": "2019-01-01T00:00:00",
"decommissionDate": "2024-01-01T00:00:00",
"make": "MacBook Air",
"manufacturer": "Apple"
}
You should get nothing back from this besides an OK status. When you run the GET query the product type you specified in your PUT query should show the updated, edited information you gave it.
To delete an existing computer, select DELETE then paste localhost:5000/computer/2 or any other existing computer that you wish to delete. Click send and you should get back an OK status which will indicate that the computer has been deleted from the database.