- .NET 8.0 SDK
- PostgreSQL 16.3
- Postman 11.6.1
- Docker 27.1.1
- Visual Studio Code 1.92
-
Desde la raíz del proyecto, ejecutar el siguiente comando en consola:
docker compose up
-
Al finalizar levantará el postgres con la estructura necesaria en el puerto 5434 y el API de Customers en el puerto 5244
- Abrir postman
- Importar el archivo
pfcti-customers-netcore.postman_collection.json
desde postman - Ejecutar los endpoints desde postman
- Abrir VS Code
- Tener instalado la extensión Rest Client
- Ir al archivo
test-customers.http
y ejecutar los endpoints - Para ejeccutar cada endpoint, debajo del comentario con los numerales (####), se debe de presionar la opción Send Request
-
Desde el directorio raíz, ir a directorio de Tests
cd Tests
-
Ejecutar el siguiente comando:
dotnet test
-
Tener desplegado en docker el proyecto. Ver Pasos para desplegar el proyecto en docker
-
Desde el directorio raíz, ir a la carpeta app
cd App
-
Ejecutar el siguiente comando:
dotnet run --property WarningLevel=0
Agrega un nuevo cliente
Request Ejemplo
{
"id": "123456",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
Respuesta Ejemplo
{
"id": "123456",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
o si genera algún error:
{
"errors": [
"El id del cliente que desea agregar ya existe"
]
}
Edita un cliente
Parámetros
Nombre | Descripción |
---|---|
id |
Id del cliente |
Request Ejemplo
{
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
Respuesta Ejemplo
{
"id": "123456",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
o si genera algún error:
{
"errors": [
"El cliente que desea consultar no existe"
]
}
Elimina un cliente
Parámetros
Nombre | Descripción |
---|---|
id |
Id del cliente |
Respuesta Ejemplo
123456
Consulta un cliente por el id
Parámetros
Nombre | Descripción |
---|---|
id |
Id del cliente |
Respuesta Ejemplo
{
"id": "123456",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
o si genera algún error:
{
"errors": [
"El cliente que desea consultar no existe"
]
}
Lista los clientes de acuerdo al parámetro indicado
Parámetros
Nombre | Descripción |
---|---|
orderBy |
Campo por el cual se va a ordenar la lista. Los campos disponibles son: birthDate , id , name |
Respuesta Ejemplo
[
{
"id": "133333333",
"firstName": "Alejandro Esteban",
"lastName": "Navarro Sanchez",
"phone": "+50683838383",
"birthDate": "1989-04-18"
},
{
"id": "122345632",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-19"
},
{
"id": "1234562",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
},
{
"id": "123456",
"firstName": "Paul",
"lastName": "McCartney",
"phone": "+50671717171",
"birthDate": "1942-06-18"
}
]