-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathUso de la API
105 lines (86 loc) · 3.34 KB
/
Uso de la API
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
Una vez ya teniendo la API iniciada (leer Readme en github) hay que iniciar sesión o crear un nuevo usuario:
En caso de que queramos crear un nuevo usuario se utiliza http://localhost:8080/login/register (importante usar el metodo POST) con el body
{
"username":"",
"email":"",
"password":"",
"activo":""
}
el cual te creará un usuario sin roles (tenemos que terminarlo)
En caso de que queramos hacer un simple login utilizamos http://localhost:8080/login (importante usar el metodo POST) con el body
{
"email":"",
"password":""
}
Esto nos dará un token, si lo hemos echo correctamente, que nos permitirá manegar la api
1. Denuncias:
Petición GET:
Para las peticiones get se pueden hacer mediante la url http://localhost:8080/denuncias para que nos muestre todas las denuncias existentes o
http://localhost:8080/denuncias/{id} para que nos muestre la información de una denuncia en específico
Petición POST:
Para la petición post utilizaremos la url http://localhost:8080/denuncias y en el body le enviaremos un JSON con la siguiente estructura
{
"denunciantes": "",
"curso": ,
"letra": ,
"resumen": "",
"fechaCreacion": "2024-09-11T10:30:00",
"validado": "",
"activo": "",
"usuario": {
"id":
}
}
**
Enums:
Curso Letra Números
PRIMERO, A, 0,
SEGUNDO, B, 1,
TERCERO, C, 2,
CUARTO D 3
Petición PUT:
En la petición PUT podemos cambiar tanto el resumen, validado y activo, para ello utilizaremos la url http://localhost:8080/denuncias/{id} y utilizamos
un JSON como:
{
"resumen": "",
"denunciantes":"",
"curso": ,
"letra": ,
"validado": "",
"activo": ""
}
La petición DELETE:
Esta petición podemos hacerla de dos maneras tanto enviando la id de la denuncia mediante la url http://localhost:8080/denuncias/{id} como con una instancia
de la denuncia en caso de que dispongas de ella con la url http://localhost:8080/denuncias y petición tipo denuncias
2. Usuarios
Dentro de los usuarios hay que aclarar que si es la primera vez que corres la aplicación se creará un primer usuario con id 1 además de que se crearán los
roles predefinidos ADMIN con id 1 y USER con id 2
Petición GET:
En la petición get utilizaremos la URL http://localhost:8080/users para mostrar toda la lista de usuarios y la URL http://localhost:8080/users/{id} en caso
de que queramos ver un usuario en concreto
Petición POST:
En la petición post utilizamos la URL http://localhost:8080/users y utilizamos el JSON con el siguiente formato:
{
"username": "",
"email": "",
"password": "",
"activo": "",
"roles": [
{
"id":
}
// Aqui podemos agregar otra llave en caso de ponerle otro rol
]
}
Petición PUT:
Para la petición put utilizamos la url http://localhost:8080/users/{id} y podemos cambiar los siguientes campos:
{
"username": "",
"email": "",
"password": "",
"activo": ""
}
La petición DELETE:
En la petición delete utilizamos como en denuncias tanto una instancia entera como su id, para borrar un usuario solo con su id utilizamos la URL
http://localhost:8080/users/{id} pero si le pasamos la instancia es con http://localhost:8080/users
aaaa