aloux-iam 0.0.117 → 0.0.119

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/swagger.yaml CHANGED
@@ -1,1232 +1,1232 @@
1
- openapi: 3.0.0
2
- info:
3
- title: aloux-sdk
4
- description: APIs para Aloux SDK
5
- version: 1.0.0
6
- contact:
7
- name: API Aloux
8
- url: https://aloux.mx
9
- email: developer@aloux.mx
10
- components:
11
- securitySchemes:
12
- bearerAuth: # arbitrary name for the security scheme
13
- type: http
14
- scheme: bearer
15
- bearerFormat: JWT
16
- paths:
17
- /iam/auth/email:
18
- post:
19
- summary: Validar que el correo exista
20
- tags:
21
- - users - self
22
- description: Validar que el correo exista
23
- requestBody:
24
- content:
25
- 'application/json':
26
- schema:
27
- properties:
28
- email:
29
- description: email
30
- type: string
31
- example: developer@aloux.mx
32
- code:
33
- description: code
34
- type: string
35
- example: true
36
- required:
37
- - email
38
- responses:
39
- '200': # status code
40
- description: Ok
41
- content:
42
- application/json:
43
- schema:
44
- type: object
45
- items:
46
- type: string
47
- /iam/auth/login:
48
- post:
49
- summary: Iniciar sesión
50
- tags:
51
- - users - self
52
- description: Iniciar sesión
53
- requestBody:
54
- content:
55
- 'application/json':
56
- schema:
57
- properties:
58
- email:
59
- description: email
60
- type: string
61
- example: developer@aloux.mx
62
- pwd:
63
- description: password
64
- type: string
65
- example: Cc123456
66
- required:
67
- - email
68
- - pwd
69
- responses:
70
- '200': # status code
71
- description: Return token
72
- content:
73
- application/json:
74
- schema:
75
- type: object
76
- items:
77
- type: string
78
- /iam/auth/verify/mail:
79
- post:
80
- tags:
81
- - users - self
82
- summary: Enviar correo para verificar correo de la cuenta
83
- description: Enviar correo para verificar correo de la cuenta
84
- requestBody:
85
- content:
86
- 'application/json':
87
- schema:
88
- properties:
89
- email:
90
- description: email
91
- type: string
92
- example: developer@aloux.mx
93
- required:
94
- - email
95
- responses:
96
- '200':
97
- description: ok
98
- content:
99
- application/json:
100
- schema:
101
- type: object
102
- items:
103
- type: string
104
- /iam/auth/verify/mail/token/{token}:
105
- get:
106
- parameters:
107
- - name: token
108
- in: path
109
- description: token de verificación de cuenta
110
- required: true
111
- schema:
112
- type: string
113
- summary: Valida correo de la cuenta (Manda coreo de bienvenida)
114
- tags:
115
- - users - self
116
- description: Valida correo de la cuenta (Manda coreo de bienvenida)
117
- responses:
118
- '200': # status code
119
- description: Return token
120
- content:
121
- application/json:
122
- schema:
123
- type: object
124
- items:
125
- type: string
126
- /iam/auth/forgot/password:
127
- post:
128
- summary: Enviar código a correo
129
- tags:
130
- - users - self
131
- description: Enviar código a correo
132
- requestBody:
133
- content:
134
- 'application/json':
135
- schema:
136
- properties:
137
- email:
138
- description: email
139
- type: string
140
- example: developer@aloux.mx
141
- required:
142
- - email
143
- responses:
144
- '200': # status code
145
- description: Ok
146
- content:
147
- application/json:
148
- schema:
149
- type: object
150
- items:
151
- type: string
152
- /iam/auth/signup:
153
- post:
154
- summary: Registrarse
155
- tags:
156
- - users - self
157
- description: Crea una cuenta
158
- requestBody:
159
- content:
160
- 'application/json':
161
- schema:
162
- properties:
163
- name:
164
- description: Name
165
- type: string
166
- example: Arturo
167
- lastName:
168
- description: Last name
169
- type: string
170
- example: Vázquez
171
- phone:
172
- description: Phone
173
- type: string
174
- example: 1234567891011
175
- maxLength: 13
176
- email:
177
- description: email
178
- type: string
179
- example: developer@aloux.mx
180
- pwd:
181
- description: password
182
- type: string
183
- example: password
184
- minLength: 8
185
- data:
186
- type: object
187
- properties:
188
- age:
189
- description: Age
190
- type: integer
191
- example: 26
192
- gender:
193
- description: Gender
194
- type: string
195
- enum: ["male","female"]
196
- scholarship:
197
- description: Scholarship
198
- type: string
199
- example: university
200
- Entity:
201
- description: Entity
202
- type: string
203
- example: Puebla
204
- required:
205
- - name
206
- - lastName
207
- - phone
208
- - email
209
- - pwd
210
- - data
211
- responses:
212
- '200': # status code
213
- description: Ok
214
- content:
215
- application/json:
216
- schema:
217
- type: object
218
- items:
219
- type: string
220
- /iam/auth/validate/code:
221
- post:
222
- summary: Verificar código
223
- tags:
224
- - users - self
225
- description: Verificar código
226
- requestBody:
227
- content:
228
- 'application/json':
229
- schema:
230
- properties:
231
- email:
232
- description: email
233
- type: string
234
- example: developer@aloux.mx
235
- resetCode:
236
- description: código de verificación
237
- type: number
238
- example: 2137
239
- required:
240
- - email
241
- responses:
242
- '200': # status code
243
- description: ok
244
- content:
245
- application/json:
246
- schema:
247
- type: object
248
- items:
249
- type: string
250
- /iam/auth/reset/password:
251
- post:
252
- summary: Reestablecer contraseña
253
- tags:
254
- - users - self
255
- description: Reestablecer contraseña
256
- requestBody:
257
- content:
258
- 'application/json':
259
- schema:
260
- properties:
261
- email:
262
- description: email
263
- type: string
264
- example: developer@aloux.mx
265
- pwd:
266
- description: contraseña nueva
267
- type: string
268
- example: "Cc123456"
269
- resetCode:
270
- description: código de verificación
271
- type: string
272
- example: 2137
273
- required:
274
- - email
275
- - pwd
276
- - resetCode
277
- responses:
278
- '200': # status code
279
- description: Return token
280
- content:
281
- application/json:
282
- schema:
283
- type: object
284
- items:
285
- type: string
286
- /iam/auth/me:
287
- get:
288
- summary: Obtener información de usuario autenticado
289
- tags:
290
- - users - self
291
- description: Obtener información de usuario autenticado
292
- security:
293
- - bearerAuth: []
294
- responses:
295
- '200': # status code
296
- description: A JSON object of a client
297
- content:
298
- application/json:
299
- schema:
300
- type: object
301
- items:
302
- type: string
303
- /iam/auth/profile:
304
- put:
305
- summary: Actualizar perfil
306
- tags:
307
- - users - self
308
- description: Actualizar perfil
309
- security:
310
- - bearerAuth: []
311
- requestBody:
312
- content:
313
- application/json:
314
- schema:
315
- properties:
316
- name:
317
- type: string
318
- example: Martín
319
- lastName:
320
- type: string
321
- example: Martínez
322
- email:
323
- description: email
324
- type: string
325
- example: developer@aloux.mx
326
- pwd:
327
- description: password
328
- type: string
329
- example: Cc12345
330
- phone:
331
- type: string
332
- example: +525567087001
333
- _functions:
334
- type: array
335
- items:
336
- type: string
337
- format: ObjectId
338
- example: "61b06de713a90b4d6dce7224"
339
- _client:
340
- type: array
341
- items:
342
- type: string
343
- format: ObjectId
344
- example: "64371ab1b6dc1417c9c0b812"
345
- required:
346
- - email
347
- - pwd
348
- responses:
349
- '202': # status code
350
- description: A JSON object of a client
351
- content:
352
- application/json:
353
- schema:
354
- type: object
355
- items:
356
- type: string
357
- /iam/auth/profile/pictura:
358
- put:
359
- summary: Actualizar solo la foto de perfil
360
- tags:
361
- - users - self
362
- description: Actualizar solo la foto de perfil
363
- security:
364
- - bearerAuth: []
365
- requestBody:
366
- content:
367
- multipart/form-data:
368
- schema:
369
- type: object
370
- properties:
371
- urlImg:
372
- description: Variable en donde se carga la imagen seleccionada del usuario
373
- type: string
374
- format: binary
375
- responses:
376
- '202': # status code
377
- description: Retorna el estado de actualización de la imagen de perfil del usuario
378
- content:
379
- application/json:
380
- schema:
381
- type: object
382
- items:
383
- type: string
384
- /iam/auth/send/verify/phone:
385
- post:
386
- summary: Enviar código al teléfono de la cuenta para verificarla
387
- tags:
388
- - users - self
389
- description: Enviar código al teléfono de la cuenta para verificarla
390
- security:
391
- - bearerAuth: []
392
- requestBody:
393
- content:
394
- application/json:
395
- schema:
396
- properties:
397
- phone:
398
- description: Teléfono de la cuenta del usuario
399
- type: string
400
- example: "+522491609423"
401
- responses:
402
- '200': # status code
403
- description: ok
404
- content:
405
- application/json:
406
- schema:
407
- type: object
408
- items:
409
- type: string
410
- /iam/auth/verify/phone:
411
- post:
412
- summary: Valida teléfono del usuario de la cuenta
413
- tags:
414
- - users - self
415
- description: Valida teléfono del usuario de la cuenta
416
- security:
417
- - bearerAuth: []
418
- requestBody:
419
- content:
420
- application/json:
421
- schema:
422
- properties:
423
- codeVerifyPhone:
424
- description: Código de verificación
425
- type: number
426
- example: 2137
427
- responses:
428
- '200': # status code
429
- description: ok
430
- content:
431
- application/json:
432
- schema:
433
- type: object
434
- items:
435
- type: string
436
- /iam/auth/logout:
437
- post:
438
- summary: Cerrar sesión
439
- tags:
440
- - users - self
441
- description: Cierra la sesión de mi usuario
442
- security:
443
- - bearerAuth: []
444
- responses:
445
- '200': # status code
446
- description: Ok
447
- content:
448
- application/json:
449
- schema:
450
- type: object
451
- items:
452
- type: string
453
- /iam/user:
454
- post:
455
- summary: Crear un usuario
456
- tags:
457
- - users
458
- description: Crea un nuevo usuario
459
- security:
460
- - bearerAuth: []
461
- requestBody:
462
- content:
463
- application/json:
464
- schema:
465
- properties:
466
- name:
467
- type: string
468
- example: Martín
469
- lastName:
470
- type: string
471
- example: Martínez
472
- email:
473
- description: email
474
- type: string
475
- example: developer@aloux.mx
476
- pwd:
477
- description: password
478
- type: string
479
- example: Cc12345
480
- phone:
481
- type: string
482
- example: +525567087001
483
- _functions:
484
- type: array
485
- items:
486
- type: string
487
- format: ObjectId
488
- example: "61b06de713a90b4d6dce7224"
489
- _client:
490
- type: array
491
- items:
492
- type: string
493
- format: ObjectId
494
- example: "64371ab1b6dc1417c9c0b812"
495
- required:
496
- - email
497
- - pwd
498
- responses:
499
- '200': # status code
500
- description: Ok
501
- get:
502
- summary: Obtener todos los usuario
503
- tags:
504
- - users
505
- description: Obtener todos los usuario
506
- security:
507
- - bearerAuth: []
508
- responses:
509
- '200': # status code
510
- description: Retorna una lista de objetos de los usuarios registrados
511
- /iam/user/{USER_ID}:
512
- get:
513
- parameters:
514
- - name: USER_ID
515
- in: path
516
- description: Obtener detalle de usuario
517
- required: true
518
- schema:
519
- type: string
520
- format: ObjectId
521
- summary: Obtener detalle de usuario
522
- tags:
523
- - users
524
- description: Obtener detalle de usuario
525
- security:
526
- - bearerAuth: []
527
- responses:
528
- '200': # status code
529
- description: Retorna un objeto JSON de un usuario
530
- patch:
531
- parameters:
532
- - name: USER_ID
533
- in: path
534
- description: ID de un usuario que este registrado
535
- required: true
536
- schema:
537
- type: string
538
- format: ObjectId
539
- summary: Actualizar usuario
540
- tags:
541
- - users
542
- description: Actualizar usuario
543
- security:
544
- - bearerAuth: []
545
- requestBody:
546
- content:
547
- 'application/json':
548
- schema:
549
- properties:
550
- name:
551
- type: string
552
- example: Martín
553
- lastName:
554
- type: string
555
- example: Martínez
556
- phone:
557
- type: string
558
- example: +525567087001
559
- email:
560
- description: email
561
- type: string
562
- example: developer@aloux.mx
563
- pwd:
564
- description: password
565
- type: string
566
- example: Cc12345
567
- required:
568
- - email
569
- - pwd
570
- responses:
571
- '200': # status code
572
- description: Retorna un objeto JSON de un usuario
573
- delete:
574
- parameters:
575
- - name: USER_ID
576
- in: path
577
- description: ID de un usuario que este registrado
578
- required: true
579
- schema:
580
- type: string
581
- format: ObjectId
582
- summary: Eliminar usuario
583
- tags:
584
- - users
585
- description: Eliminar usuario
586
- security:
587
- - bearerAuth: []
588
- responses:
589
- '200': # status code
590
- description: Ok
591
- /iam/user/{USER_ID}/status:
592
- put:
593
- parameters:
594
- - name: USER_ID
595
- in: path
596
- description: ID de un usuario que este registrado
597
- required: true
598
- schema:
599
- type: string
600
- format: ObjectId
601
- summary: Activar o desactivar usuario
602
- tags:
603
- - users
604
- description: Activar o desactivar usuario
605
- security:
606
- - bearerAuth: []
607
- requestBody:
608
- content:
609
- 'application/json':
610
- schema:
611
- properties:
612
- status:
613
- type: string
614
- example: Activo
615
- responses:
616
- '200': # status code
617
- description: Retorna result from response
618
- /iam/user/password/{USER_ID}:
619
- put:
620
- parameters:
621
- - name: USER_ID
622
- in: path
623
- description: ID de un usuario que este registrado
624
- required: true
625
- schema:
626
- type: string
627
- format: ObjectId
628
- summary: Actualizar la constraseña de un usuario
629
- tags:
630
- - users
631
- description: Actualizar la constraseña de un usuario
632
- security:
633
- - bearerAuth: []
634
- requestBody:
635
- content:
636
- 'application/json':
637
- schema:
638
- properties:
639
- pwd:
640
- type: string
641
- example: Cc12345
642
- responses:
643
- '200': # status code
644
- description: Retorna result from response
645
- /iam/user/count/all:
646
- get:
647
- summary: Obtiene el número de usuarios
648
- tags:
649
- - users
650
- description: Obtiene el número de usuarios
651
- security:
652
- - bearerAuth: []
653
- responses:
654
- '200': # status code
655
- description: Retorna el resultado de la respuesta
656
- /iam/functions:
657
- post:
658
- summary: Crea una función
659
- tags:
660
- - functions
661
- description: Crea una función
662
- security:
663
- - bearerAuth: []
664
- requestBody:
665
- content:
666
- 'application/json':
667
- schema:
668
- properties:
669
- name:
670
- type: string
671
- example: Propietario
672
- description:
673
- type: string
674
- example: Acceso a todas las funcionalidades de la plataforma
675
- _permissions:
676
- type: string
677
- format: ObjectId
678
- example: "61b06de713a90b4d6dce5141"
679
- required:
680
- - name
681
- responses:
682
- '201': # status code
683
- description: ok
684
- get:
685
- summary: Obtener todas las funciones
686
- tags:
687
- - functions
688
- description: Obtener todas las funciones
689
- security:
690
- - bearerAuth: []
691
- responses:
692
- '200': # status code
693
- description: Retorna el resultado de la respuesta
694
- /iam/functions/{FUNCTION_ID}:
695
- get:
696
- parameters:
697
- - name: FUNCTION_ID
698
- in: path
699
- description: ID de un funcion que este registrada
700
- required: true
701
- schema:
702
- type: string
703
- format: ObjectId
704
- summary: Obtener detalle de la función
705
- tags:
706
- - functions
707
- description: Obtener detalle de la función
708
- security:
709
- - bearerAuth: []
710
- responses:
711
- '200': # status code
712
- description: Retorna el resultado de la respuesta
713
- patch:
714
- parameters:
715
- - name: FUNCTION_ID
716
- in: path
717
- description: ID de una función que este registrada
718
- required: true
719
- schema:
720
- type: string
721
- format: ObjectId
722
- summary: Actualizar función
723
- tags:
724
- - functions
725
- description: Actualizar función
726
- security:
727
- - bearerAuth: []
728
- requestBody:
729
- content:
730
- 'application/json':
731
- schema:
732
- properties:
733
- name:
734
- type: string
735
- example: Propietario
736
- description:
737
- type: string
738
- example: Acceso a todas las funcionalidades de la plataforma
739
- _permissions:
740
- type: string
741
- format: ObjectId
742
- example: "61b06de713a90b4d6dce5141"
743
- required:
744
- - name
745
- responses:
746
- '200': # status code
747
- description: Retorna un objeto JSON de una función
748
- delete:
749
- parameters:
750
- - name: FUNCTION_ID
751
- in: path
752
- description: ID de una función que este registrado
753
- required: true
754
- schema:
755
- type: string
756
- format: ObjectId
757
- summary: Eliminar función
758
- tags:
759
- - functions
760
- description: Eliminar función
761
- security:
762
- - bearerAuth: []
763
- responses:
764
- '200': # status code
765
- description: Ok
766
- /iam/functions/{FUNCTION_ID}/status:
767
- put:
768
- parameters:
769
- - name: FUNCTION_ID
770
- in: path
771
- description: ID de una función que este registrada
772
- required: true
773
- schema:
774
- type: string
775
- format: ObjectId
776
- summary: Activar o desactivar función
777
- tags:
778
- - functions
779
- description: Activar o desactivar función
780
- security:
781
- - bearerAuth: []
782
- requestBody:
783
- content:
784
- 'application/json':
785
- schema:
786
- properties:
787
- status:
788
- type: string
789
- example: Activo
790
- responses:
791
- '200': # status code
792
- description: Retorna el resultado de la respuesta
793
- /iam/functions/count/all:
794
- get:
795
- summary: Obtiene el número de funciones
796
- tags:
797
- - functions
798
- description: Obtiene el número de funciones
799
- security:
800
- - bearerAuth: []
801
- responses:
802
- '200': # status code
803
- description: Retorna el resultado de la respuesta
804
- /iam/permission:
805
- post:
806
- summary: Crea un permiso
807
- tags:
808
- - permissions
809
- description: Crea un permiso
810
- security:
811
- - bearerAuth: []
812
- requestBody:
813
- content:
814
- 'application/json':
815
- schema:
816
- properties:
817
- description:
818
- description: Describe la funcionalidad del permiso
819
- type: string
820
- method:
821
- description: Tipo de HTTP REQUEST del permiso
822
- type: string
823
- example: GET
824
- api:
825
- description: ruta que accede a la función que utilice el permiso
826
- type: string
827
- example: "api.create"
828
- endpoint:
829
- description: path del permiso
830
- type: string
831
- example: "/api/permissions"
832
- auth:
833
- description: Identifica si para acceder al permiso necesita un token o es público
834
- type: number
835
- example: 1
836
- _menu:
837
- description: hace referencia a si el permiso pertenece a un menú en especifíco
838
- type: string
839
- format: ObjectId
840
- example: "61b06de713a90b4d6dce7171"
841
- required:
842
- - description
843
- - method
844
- - api
845
- - endpoint
846
- - _menu
847
- responses:
848
- '201': # status code
849
- description: retorna el resultado de la respuesta
850
- get:
851
- summary: Obtener todos los permisos
852
- tags:
853
- - permissions
854
- description: Obtener todos los permisos
855
- security:
856
- - bearerAuth: []
857
- responses:
858
- '200': # status code
859
- description: Retorna una lista de objetos JSON
860
- /iam/permission/{PERMISSION_ID}:
861
- get:
862
- parameters:
863
- - name: PERMISSION_ID
864
- in: path
865
- description: ID de un permiso que este registrado
866
- required: true
867
- schema:
868
- type: string
869
- format: ObjectId
870
- summary: Obtener detalle del permiso
871
- tags:
872
- - permissions
873
- description: Obtener detalle del permiso
874
- security:
875
- - bearerAuth: []
876
- responses:
877
- '200': # status code
878
- description: Retorna un objeto JSON
879
- patch:
880
- parameters:
881
- - name: PERMISSION_ID
882
- in: path
883
- description: ID de un permiso que este registrado
884
- required: true
885
- schema:
886
- type: string
887
- format: ObjectId
888
- summary: Actualizar permiso
889
- tags:
890
- - permissions
891
- description: Actualizar permiso
892
- security:
893
- - bearerAuth: []
894
- requestBody:
895
- content:
896
- 'application/json':
897
- schema:
898
- properties:
899
- description:
900
- description: Describe la funcionalidad del permiso
901
- type: string
902
- method:
903
- description: Tipo de HTTP REQUEST del permiso
904
- type: string
905
- example: GET
906
- api:
907
- description: ruta que accede a la función que utilice el permiso
908
- type: string
909
- example: "api.create"
910
- endpoint:
911
- description: path del permiso
912
- type: string
913
- example: "/api/permissions"
914
- auth:
915
- description: Identifica si para acceder al permiso necesita un token o es público
916
- type: number
917
- example: 1
918
- _menu:
919
- description: hace referencia a si el permiso pertenece a un menú en especifíco
920
- type: string
921
- format: ObjectId
922
- example: "61b06de713a90b4d6dce7171"
923
- responses:
924
- '200': # status code
925
- description: Retorna un objeto JSON de un permiso
926
- delete:
927
- parameters:
928
- - name: PERMISSION_ID
929
- in: path
930
- description: ID de un permiso que este registrado
931
- required: true
932
- schema:
933
- type: string
934
- format: ObjectId
935
- summary: Eliminar permiso
936
- tags:
937
- - permissions
938
- description: Eliminar permiso
939
- security:
940
- - bearerAuth: []
941
- responses:
942
- '200': # status code
943
- description: Ok
944
- /iam/permission/{PERMISSION_ID}/status:
945
- put:
946
- parameters:
947
- - name: PERMISSION_ID
948
- in: path
949
- description: ID de un permiso que este registrado
950
- required: true
951
- schema:
952
- type: string
953
- format: ObjectId
954
- summary: Activar o desactivar permiso
955
- tags:
956
- - permissions
957
- description: Activar o desactivar permiso
958
- security:
959
- - bearerAuth: []
960
- requestBody:
961
- content:
962
- 'application/json':
963
- schema:
964
- properties:
965
- status:
966
- type: string
967
- example: Activo
968
- responses:
969
- '200': # status code
970
- description: Retorna el resultado de la respuesta
971
- /iam/permission/count/all:
972
- get:
973
- summary: Obtiene el número de permisos
974
- tags:
975
- - permissions
976
- description: Obtiene el número de permisos
977
- security:
978
- - bearerAuth: []
979
- responses:
980
- '200': # status code
981
- description: Retorna el resultado de la respuesta
982
- /iam/menu:
983
- post:
984
- summary: Crea un menú
985
- tags:
986
- - menús
987
- description: Crea un menú
988
- security:
989
- - bearerAuth: []
990
- requestBody:
991
- content:
992
- application/json:
993
- schema:
994
- properties:
995
- label:
996
- description: Nombre del Menú
997
- type: string
998
- example: "IAM"
999
- path:
1000
- description: Ruta de acceso al menú
1001
- type: string
1002
- example: "/dashboard/iam"
1003
- icon:
1004
- description: icono del menú
1005
- type: string
1006
- example: "mdi-shield-account"
1007
- index:
1008
- description: path del permiso
1009
- type: number
1010
- example: 1
1011
- _menu:
1012
- description: hace referencia a si el menú que se va a crear es un submenú de un menú ya registrado
1013
- type: string
1014
- format: ObjectId
1015
- example: "61b06de713a90b4d6dce7171"
1016
- required:
1017
- - label
1018
- - path
1019
- - icon
1020
- responses:
1021
- '201': # status code
1022
- description: retorna un objeto JSON
1023
- get:
1024
- summary: Obtiene todos los elementos de menú
1025
- tags:
1026
- - menús
1027
- description: Obtiene todos los elementos de menú
1028
- security:
1029
- - bearerAuth: []
1030
- responses:
1031
- '200': # status code
1032
- description: Retorna una lista de objetos JSON
1033
- /iam/menu/{MENU_ID}:
1034
- get:
1035
- parameters:
1036
- - name: MENU_ID
1037
- in: path
1038
- description: ID de un menú que este registrado
1039
- required: true
1040
- schema:
1041
- type: string
1042
- format: ObjectId
1043
- summary: Obtiene el detalle de un elemento de menú
1044
- tags:
1045
- - menús
1046
- description: Obtiene el detalle de un elemento de menú
1047
- security:
1048
- - bearerAuth: []
1049
- responses:
1050
- '200': # status code
1051
- description: Retorna un objeto JSON
1052
- patch:
1053
- parameters:
1054
- - name: MENU_ID
1055
- in: path
1056
- description: ID de un menú que este registrado
1057
- required: true
1058
- schema:
1059
- type: string
1060
- format: ObjectId
1061
- summary: Actualiza un elemento de menú
1062
- tags:
1063
- - menús
1064
- description: Actualiza un elemento de menú
1065
- security:
1066
- - bearerAuth: []
1067
- requestBody:
1068
- content:
1069
- 'application/json':
1070
- schema:
1071
- properties:
1072
- label:
1073
- description: Nombre del Menú
1074
- type: string
1075
- example: "IAM"
1076
- path:
1077
- description: Ruta de acceso al menú
1078
- type: string
1079
- example: "/dashboard/iam"
1080
- icon:
1081
- description: icono del menú
1082
- type: string
1083
- example: "mdi-shield-account"
1084
- index:
1085
- description: path del permiso
1086
- type: number
1087
- example: 1
1088
- _menu:
1089
- description: hace referencia a si el menú que se va a crear es un submenú de un menú ya registrado
1090
- type: string
1091
- format: ObjectId
1092
- example: "61b06de713a90b4d6dce7171"
1093
- required:
1094
- - label
1095
- - path
1096
- - icon
1097
- responses:
1098
- '200': # status code
1099
- description: Retorna un objeto JSON
1100
- delete:
1101
- parameters:
1102
- - name: MENU_ID
1103
- in: path
1104
- description: ID de un menú que este registrado
1105
- required: true
1106
- schema:
1107
- type: string
1108
- format: ObjectId
1109
- summary: Elimina un elemento de menú
1110
- tags:
1111
- - menús
1112
- description: Elimina un elemento de menú
1113
- security:
1114
- - bearerAuth: []
1115
- responses:
1116
- '200': # status code
1117
- description: Ok
1118
- /iam/menu/{MENU_ID}/status:
1119
- put:
1120
- parameters:
1121
- - name: MENU_ID
1122
- in: path
1123
- description: ID de un menú que este registrado
1124
- required: true
1125
- schema:
1126
- type: string
1127
- format: ObjectId
1128
- summary: Activa o desactiva un menú
1129
- tags:
1130
- - menús
1131
- description: Activa o desactiva un menú
1132
- security:
1133
- - bearerAuth: []
1134
- requestBody:
1135
- content:
1136
- application/json:
1137
- schema:
1138
- properties:
1139
- status:
1140
- type: string
1141
- example: Activo
1142
- responses:
1143
- '200': # status code
1144
- description: Retorna el resultado de la respuesta
1145
- /iam/menu/count/all:
1146
- get:
1147
- summary: Obtiene el número de menús
1148
- tags:
1149
- - menús
1150
- description: Obtiene el número de menús
1151
- security:
1152
- - bearerAuth: []
1153
- responses:
1154
- '200': # status code
1155
- description: Retorna el resultado de la respuesta
1156
- /iam/menu/order:
1157
- post:
1158
- summary: Ordena los elementos de menú
1159
- tags:
1160
- - menús
1161
- description: Ordena los elementos de menú
1162
- security:
1163
- - bearerAuth: []
1164
- requestBody:
1165
- content:
1166
- 'application/json':
1167
- schema:
1168
- properties:
1169
- length:
1170
- type: object
1171
- properties:
1172
- _id:
1173
- type: string
1174
- format: ObjectId
1175
- example: 64bab1c64b2bce1394cc6491
1176
- index:
1177
- type: number
1178
- example: 54
1179
- responses:
1180
- '200': # status code
1181
- description: Retorna el resultado de la respuesta
1182
- /iam/history:
1183
- post:
1184
- summary: Obtener todo el historial paginado
1185
- tags:
1186
- - History
1187
- description: Ordena los elementos de menú
1188
- security:
1189
- - bearerAuth: []
1190
- requestBody:
1191
- content:
1192
- 'application/json':
1193
- schema:
1194
- properties:
1195
- filter:
1196
- type: object
1197
- properties:
1198
- method:
1199
- enum: [ GET, POST, PUT, PATCH, DELETE]
1200
- description:
1201
- type: string
1202
- example: crear
1203
- config:
1204
- type: object
1205
- properties:
1206
- page:
1207
- type: number
1208
- example: 1
1209
- itemsPerPage:
1210
- type: number
1211
- example: 10
1212
- responses:
1213
- '200': # status code
1214
- description: Retorna el resultado de la respuesta
1215
- /iam/history/{HISTORY_ID}:
1216
- get:
1217
- parameters:
1218
- - name: HISTORY_ID
1219
- in: path
1220
- description: ID de un registro de historial
1221
- required: true
1222
- schema:
1223
- type: string
1224
- format: ObjectId
1225
- tags:
1226
- - History
1227
- description: Detalle de u registro de historial
1228
- security:
1229
- - bearerAuth: []
1230
- responses:
1231
- '200': # status code
1
+ openapi: 3.0.0
2
+ info:
3
+ title: aloux-sdk
4
+ description: APIs para Aloux SDK
5
+ version: 1.0.0
6
+ contact:
7
+ name: API Aloux
8
+ url: https://aloux.mx
9
+ email: developer@aloux.mx
10
+ components:
11
+ securitySchemes:
12
+ bearerAuth: # arbitrary name for the security scheme
13
+ type: http
14
+ scheme: bearer
15
+ bearerFormat: JWT
16
+ paths:
17
+ /iam/auth/email:
18
+ post:
19
+ summary: Validar que el correo exista
20
+ tags:
21
+ - users - self
22
+ description: Validar que el correo exista
23
+ requestBody:
24
+ content:
25
+ 'application/json':
26
+ schema:
27
+ properties:
28
+ email:
29
+ description: email
30
+ type: string
31
+ example: developer@aloux.mx
32
+ code:
33
+ description: code
34
+ type: string
35
+ example: true
36
+ required:
37
+ - email
38
+ responses:
39
+ '200': # status code
40
+ description: Ok
41
+ content:
42
+ application/json:
43
+ schema:
44
+ type: object
45
+ items:
46
+ type: string
47
+ /iam/auth/login:
48
+ post:
49
+ summary: Iniciar sesión
50
+ tags:
51
+ - users - self
52
+ description: Iniciar sesión
53
+ requestBody:
54
+ content:
55
+ 'application/json':
56
+ schema:
57
+ properties:
58
+ email:
59
+ description: email
60
+ type: string
61
+ example: developer@aloux.mx
62
+ pwd:
63
+ description: password
64
+ type: string
65
+ example: Cc123456
66
+ required:
67
+ - email
68
+ - pwd
69
+ responses:
70
+ '200': # status code
71
+ description: Return token
72
+ content:
73
+ application/json:
74
+ schema:
75
+ type: object
76
+ items:
77
+ type: string
78
+ /iam/auth/verify/mail:
79
+ post:
80
+ tags:
81
+ - users - self
82
+ summary: Enviar correo para verificar correo de la cuenta
83
+ description: Enviar correo para verificar correo de la cuenta
84
+ requestBody:
85
+ content:
86
+ 'application/json':
87
+ schema:
88
+ properties:
89
+ email:
90
+ description: email
91
+ type: string
92
+ example: developer@aloux.mx
93
+ required:
94
+ - email
95
+ responses:
96
+ '200':
97
+ description: ok
98
+ content:
99
+ application/json:
100
+ schema:
101
+ type: object
102
+ items:
103
+ type: string
104
+ /iam/auth/verify/mail/token/{token}:
105
+ get:
106
+ parameters:
107
+ - name: token
108
+ in: path
109
+ description: token de verificación de cuenta
110
+ required: true
111
+ schema:
112
+ type: string
113
+ summary: Valida correo de la cuenta (Manda coreo de bienvenida)
114
+ tags:
115
+ - users - self
116
+ description: Valida correo de la cuenta (Manda coreo de bienvenida)
117
+ responses:
118
+ '200': # status code
119
+ description: Return token
120
+ content:
121
+ application/json:
122
+ schema:
123
+ type: object
124
+ items:
125
+ type: string
126
+ /iam/auth/forgot/password:
127
+ post:
128
+ summary: Enviar código a correo
129
+ tags:
130
+ - users - self
131
+ description: Enviar código a correo
132
+ requestBody:
133
+ content:
134
+ 'application/json':
135
+ schema:
136
+ properties:
137
+ email:
138
+ description: email
139
+ type: string
140
+ example: developer@aloux.mx
141
+ required:
142
+ - email
143
+ responses:
144
+ '200': # status code
145
+ description: Ok
146
+ content:
147
+ application/json:
148
+ schema:
149
+ type: object
150
+ items:
151
+ type: string
152
+ /iam/auth/signup:
153
+ post:
154
+ summary: Registrarse
155
+ tags:
156
+ - users - self
157
+ description: Crea una cuenta
158
+ requestBody:
159
+ content:
160
+ 'application/json':
161
+ schema:
162
+ properties:
163
+ name:
164
+ description: Name
165
+ type: string
166
+ example: Arturo
167
+ lastName:
168
+ description: Last name
169
+ type: string
170
+ example: Vázquez
171
+ phone:
172
+ description: Phone
173
+ type: string
174
+ example: 1234567891011
175
+ maxLength: 13
176
+ email:
177
+ description: email
178
+ type: string
179
+ example: developer@aloux.mx
180
+ pwd:
181
+ description: password
182
+ type: string
183
+ example: password
184
+ minLength: 8
185
+ data:
186
+ type: object
187
+ properties:
188
+ age:
189
+ description: Age
190
+ type: integer
191
+ example: 26
192
+ gender:
193
+ description: Gender
194
+ type: string
195
+ enum: ["male","female"]
196
+ scholarship:
197
+ description: Scholarship
198
+ type: string
199
+ example: university
200
+ Entity:
201
+ description: Entity
202
+ type: string
203
+ example: Puebla
204
+ required:
205
+ - name
206
+ - lastName
207
+ - phone
208
+ - email
209
+ - pwd
210
+ - data
211
+ responses:
212
+ '200': # status code
213
+ description: Ok
214
+ content:
215
+ application/json:
216
+ schema:
217
+ type: object
218
+ items:
219
+ type: string
220
+ /iam/auth/validate/code:
221
+ post:
222
+ summary: Verificar código
223
+ tags:
224
+ - users - self
225
+ description: Verificar código
226
+ requestBody:
227
+ content:
228
+ 'application/json':
229
+ schema:
230
+ properties:
231
+ email:
232
+ description: email
233
+ type: string
234
+ example: developer@aloux.mx
235
+ resetCode:
236
+ description: código de verificación
237
+ type: number
238
+ example: 2137
239
+ required:
240
+ - email
241
+ responses:
242
+ '200': # status code
243
+ description: ok
244
+ content:
245
+ application/json:
246
+ schema:
247
+ type: object
248
+ items:
249
+ type: string
250
+ /iam/auth/reset/password:
251
+ post:
252
+ summary: Reestablecer contraseña
253
+ tags:
254
+ - users - self
255
+ description: Reestablecer contraseña
256
+ requestBody:
257
+ content:
258
+ 'application/json':
259
+ schema:
260
+ properties:
261
+ email:
262
+ description: email
263
+ type: string
264
+ example: developer@aloux.mx
265
+ pwd:
266
+ description: contraseña nueva
267
+ type: string
268
+ example: "Cc123456"
269
+ resetCode:
270
+ description: código de verificación
271
+ type: string
272
+ example: 2137
273
+ required:
274
+ - email
275
+ - pwd
276
+ - resetCode
277
+ responses:
278
+ '200': # status code
279
+ description: Return token
280
+ content:
281
+ application/json:
282
+ schema:
283
+ type: object
284
+ items:
285
+ type: string
286
+ /iam/auth/me:
287
+ get:
288
+ summary: Obtener información de usuario autenticado
289
+ tags:
290
+ - users - self
291
+ description: Obtener información de usuario autenticado
292
+ security:
293
+ - bearerAuth: []
294
+ responses:
295
+ '200': # status code
296
+ description: A JSON object of a client
297
+ content:
298
+ application/json:
299
+ schema:
300
+ type: object
301
+ items:
302
+ type: string
303
+ /iam/auth/profile:
304
+ put:
305
+ summary: Actualizar perfil
306
+ tags:
307
+ - users - self
308
+ description: Actualizar perfil
309
+ security:
310
+ - bearerAuth: []
311
+ requestBody:
312
+ content:
313
+ application/json:
314
+ schema:
315
+ properties:
316
+ name:
317
+ type: string
318
+ example: Martín
319
+ lastName:
320
+ type: string
321
+ example: Martínez
322
+ email:
323
+ description: email
324
+ type: string
325
+ example: developer@aloux.mx
326
+ pwd:
327
+ description: password
328
+ type: string
329
+ example: Cc12345
330
+ phone:
331
+ type: string
332
+ example: +525567087001
333
+ _functions:
334
+ type: array
335
+ items:
336
+ type: string
337
+ format: ObjectId
338
+ example: "61b06de713a90b4d6dce7224"
339
+ _client:
340
+ type: array
341
+ items:
342
+ type: string
343
+ format: ObjectId
344
+ example: "64371ab1b6dc1417c9c0b812"
345
+ required:
346
+ - email
347
+ - pwd
348
+ responses:
349
+ '202': # status code
350
+ description: A JSON object of a client
351
+ content:
352
+ application/json:
353
+ schema:
354
+ type: object
355
+ items:
356
+ type: string
357
+ /iam/auth/profile/pictura:
358
+ put:
359
+ summary: Actualizar solo la foto de perfil
360
+ tags:
361
+ - users - self
362
+ description: Actualizar solo la foto de perfil
363
+ security:
364
+ - bearerAuth: []
365
+ requestBody:
366
+ content:
367
+ multipart/form-data:
368
+ schema:
369
+ type: object
370
+ properties:
371
+ urlImg:
372
+ description: Variable en donde se carga la imagen seleccionada del usuario
373
+ type: string
374
+ format: binary
375
+ responses:
376
+ '202': # status code
377
+ description: Retorna el estado de actualización de la imagen de perfil del usuario
378
+ content:
379
+ application/json:
380
+ schema:
381
+ type: object
382
+ items:
383
+ type: string
384
+ /iam/auth/send/verify/phone:
385
+ post:
386
+ summary: Enviar código al teléfono de la cuenta para verificarla
387
+ tags:
388
+ - users - self
389
+ description: Enviar código al teléfono de la cuenta para verificarla
390
+ security:
391
+ - bearerAuth: []
392
+ requestBody:
393
+ content:
394
+ application/json:
395
+ schema:
396
+ properties:
397
+ phone:
398
+ description: Teléfono de la cuenta del usuario
399
+ type: string
400
+ example: "+522491609423"
401
+ responses:
402
+ '200': # status code
403
+ description: ok
404
+ content:
405
+ application/json:
406
+ schema:
407
+ type: object
408
+ items:
409
+ type: string
410
+ /iam/auth/verify/phone:
411
+ post:
412
+ summary: Valida teléfono del usuario de la cuenta
413
+ tags:
414
+ - users - self
415
+ description: Valida teléfono del usuario de la cuenta
416
+ security:
417
+ - bearerAuth: []
418
+ requestBody:
419
+ content:
420
+ application/json:
421
+ schema:
422
+ properties:
423
+ codeVerifyPhone:
424
+ description: Código de verificación
425
+ type: number
426
+ example: 2137
427
+ responses:
428
+ '200': # status code
429
+ description: ok
430
+ content:
431
+ application/json:
432
+ schema:
433
+ type: object
434
+ items:
435
+ type: string
436
+ /iam/auth/logout:
437
+ post:
438
+ summary: Cerrar sesión
439
+ tags:
440
+ - users - self
441
+ description: Cierra la sesión de mi usuario
442
+ security:
443
+ - bearerAuth: []
444
+ responses:
445
+ '200': # status code
446
+ description: Ok
447
+ content:
448
+ application/json:
449
+ schema:
450
+ type: object
451
+ items:
452
+ type: string
453
+ /iam/user:
454
+ post:
455
+ summary: Crear un usuario
456
+ tags:
457
+ - users
458
+ description: Crea un nuevo usuario
459
+ security:
460
+ - bearerAuth: []
461
+ requestBody:
462
+ content:
463
+ application/json:
464
+ schema:
465
+ properties:
466
+ name:
467
+ type: string
468
+ example: Martín
469
+ lastName:
470
+ type: string
471
+ example: Martínez
472
+ email:
473
+ description: email
474
+ type: string
475
+ example: developer@aloux.mx
476
+ pwd:
477
+ description: password
478
+ type: string
479
+ example: Cc12345
480
+ phone:
481
+ type: string
482
+ example: +525567087001
483
+ _functions:
484
+ type: array
485
+ items:
486
+ type: string
487
+ format: ObjectId
488
+ example: "61b06de713a90b4d6dce7224"
489
+ _client:
490
+ type: array
491
+ items:
492
+ type: string
493
+ format: ObjectId
494
+ example: "64371ab1b6dc1417c9c0b812"
495
+ required:
496
+ - email
497
+ - pwd
498
+ responses:
499
+ '200': # status code
500
+ description: Ok
501
+ get:
502
+ summary: Obtener todos los usuario
503
+ tags:
504
+ - users
505
+ description: Obtener todos los usuario
506
+ security:
507
+ - bearerAuth: []
508
+ responses:
509
+ '200': # status code
510
+ description: Retorna una lista de objetos de los usuarios registrados
511
+ /iam/user/{USER_ID}:
512
+ get:
513
+ parameters:
514
+ - name: USER_ID
515
+ in: path
516
+ description: Obtener detalle de usuario
517
+ required: true
518
+ schema:
519
+ type: string
520
+ format: ObjectId
521
+ summary: Obtener detalle de usuario
522
+ tags:
523
+ - users
524
+ description: Obtener detalle de usuario
525
+ security:
526
+ - bearerAuth: []
527
+ responses:
528
+ '200': # status code
529
+ description: Retorna un objeto JSON de un usuario
530
+ patch:
531
+ parameters:
532
+ - name: USER_ID
533
+ in: path
534
+ description: ID de un usuario que este registrado
535
+ required: true
536
+ schema:
537
+ type: string
538
+ format: ObjectId
539
+ summary: Actualizar usuario
540
+ tags:
541
+ - users
542
+ description: Actualizar usuario
543
+ security:
544
+ - bearerAuth: []
545
+ requestBody:
546
+ content:
547
+ 'application/json':
548
+ schema:
549
+ properties:
550
+ name:
551
+ type: string
552
+ example: Martín
553
+ lastName:
554
+ type: string
555
+ example: Martínez
556
+ phone:
557
+ type: string
558
+ example: +525567087001
559
+ email:
560
+ description: email
561
+ type: string
562
+ example: developer@aloux.mx
563
+ pwd:
564
+ description: password
565
+ type: string
566
+ example: Cc12345
567
+ required:
568
+ - email
569
+ - pwd
570
+ responses:
571
+ '200': # status code
572
+ description: Retorna un objeto JSON de un usuario
573
+ delete:
574
+ parameters:
575
+ - name: USER_ID
576
+ in: path
577
+ description: ID de un usuario que este registrado
578
+ required: true
579
+ schema:
580
+ type: string
581
+ format: ObjectId
582
+ summary: Eliminar usuario
583
+ tags:
584
+ - users
585
+ description: Eliminar usuario
586
+ security:
587
+ - bearerAuth: []
588
+ responses:
589
+ '200': # status code
590
+ description: Ok
591
+ /iam/user/{USER_ID}/status:
592
+ put:
593
+ parameters:
594
+ - name: USER_ID
595
+ in: path
596
+ description: ID de un usuario que este registrado
597
+ required: true
598
+ schema:
599
+ type: string
600
+ format: ObjectId
601
+ summary: Activar o desactivar usuario
602
+ tags:
603
+ - users
604
+ description: Activar o desactivar usuario
605
+ security:
606
+ - bearerAuth: []
607
+ requestBody:
608
+ content:
609
+ 'application/json':
610
+ schema:
611
+ properties:
612
+ status:
613
+ type: string
614
+ example: Activo
615
+ responses:
616
+ '200': # status code
617
+ description: Retorna result from response
618
+ /iam/user/password/{USER_ID}:
619
+ put:
620
+ parameters:
621
+ - name: USER_ID
622
+ in: path
623
+ description: ID de un usuario que este registrado
624
+ required: true
625
+ schema:
626
+ type: string
627
+ format: ObjectId
628
+ summary: Actualizar la constraseña de un usuario
629
+ tags:
630
+ - users
631
+ description: Actualizar la constraseña de un usuario
632
+ security:
633
+ - bearerAuth: []
634
+ requestBody:
635
+ content:
636
+ 'application/json':
637
+ schema:
638
+ properties:
639
+ pwd:
640
+ type: string
641
+ example: Cc12345
642
+ responses:
643
+ '200': # status code
644
+ description: Retorna result from response
645
+ /iam/user/count/all:
646
+ get:
647
+ summary: Obtiene el número de usuarios
648
+ tags:
649
+ - users
650
+ description: Obtiene el número de usuarios
651
+ security:
652
+ - bearerAuth: []
653
+ responses:
654
+ '200': # status code
655
+ description: Retorna el resultado de la respuesta
656
+ /iam/functions:
657
+ post:
658
+ summary: Crea una función
659
+ tags:
660
+ - functions
661
+ description: Crea una función
662
+ security:
663
+ - bearerAuth: []
664
+ requestBody:
665
+ content:
666
+ 'application/json':
667
+ schema:
668
+ properties:
669
+ name:
670
+ type: string
671
+ example: Propietario
672
+ description:
673
+ type: string
674
+ example: Acceso a todas las funcionalidades de la plataforma
675
+ _permissions:
676
+ type: string
677
+ format: ObjectId
678
+ example: "61b06de713a90b4d6dce5141"
679
+ required:
680
+ - name
681
+ responses:
682
+ '201': # status code
683
+ description: ok
684
+ get:
685
+ summary: Obtener todas las funciones
686
+ tags:
687
+ - functions
688
+ description: Obtener todas las funciones
689
+ security:
690
+ - bearerAuth: []
691
+ responses:
692
+ '200': # status code
693
+ description: Retorna el resultado de la respuesta
694
+ /iam/functions/{FUNCTION_ID}:
695
+ get:
696
+ parameters:
697
+ - name: FUNCTION_ID
698
+ in: path
699
+ description: ID de un funcion que este registrada
700
+ required: true
701
+ schema:
702
+ type: string
703
+ format: ObjectId
704
+ summary: Obtener detalle de la función
705
+ tags:
706
+ - functions
707
+ description: Obtener detalle de la función
708
+ security:
709
+ - bearerAuth: []
710
+ responses:
711
+ '200': # status code
712
+ description: Retorna el resultado de la respuesta
713
+ patch:
714
+ parameters:
715
+ - name: FUNCTION_ID
716
+ in: path
717
+ description: ID de una función que este registrada
718
+ required: true
719
+ schema:
720
+ type: string
721
+ format: ObjectId
722
+ summary: Actualizar función
723
+ tags:
724
+ - functions
725
+ description: Actualizar función
726
+ security:
727
+ - bearerAuth: []
728
+ requestBody:
729
+ content:
730
+ 'application/json':
731
+ schema:
732
+ properties:
733
+ name:
734
+ type: string
735
+ example: Propietario
736
+ description:
737
+ type: string
738
+ example: Acceso a todas las funcionalidades de la plataforma
739
+ _permissions:
740
+ type: string
741
+ format: ObjectId
742
+ example: "61b06de713a90b4d6dce5141"
743
+ required:
744
+ - name
745
+ responses:
746
+ '200': # status code
747
+ description: Retorna un objeto JSON de una función
748
+ delete:
749
+ parameters:
750
+ - name: FUNCTION_ID
751
+ in: path
752
+ description: ID de una función que este registrado
753
+ required: true
754
+ schema:
755
+ type: string
756
+ format: ObjectId
757
+ summary: Eliminar función
758
+ tags:
759
+ - functions
760
+ description: Eliminar función
761
+ security:
762
+ - bearerAuth: []
763
+ responses:
764
+ '200': # status code
765
+ description: Ok
766
+ /iam/functions/{FUNCTION_ID}/status:
767
+ put:
768
+ parameters:
769
+ - name: FUNCTION_ID
770
+ in: path
771
+ description: ID de una función que este registrada
772
+ required: true
773
+ schema:
774
+ type: string
775
+ format: ObjectId
776
+ summary: Activar o desactivar función
777
+ tags:
778
+ - functions
779
+ description: Activar o desactivar función
780
+ security:
781
+ - bearerAuth: []
782
+ requestBody:
783
+ content:
784
+ 'application/json':
785
+ schema:
786
+ properties:
787
+ status:
788
+ type: string
789
+ example: Activo
790
+ responses:
791
+ '200': # status code
792
+ description: Retorna el resultado de la respuesta
793
+ /iam/functions/count/all:
794
+ get:
795
+ summary: Obtiene el número de funciones
796
+ tags:
797
+ - functions
798
+ description: Obtiene el número de funciones
799
+ security:
800
+ - bearerAuth: []
801
+ responses:
802
+ '200': # status code
803
+ description: Retorna el resultado de la respuesta
804
+ /iam/permission:
805
+ post:
806
+ summary: Crea un permiso
807
+ tags:
808
+ - permissions
809
+ description: Crea un permiso
810
+ security:
811
+ - bearerAuth: []
812
+ requestBody:
813
+ content:
814
+ 'application/json':
815
+ schema:
816
+ properties:
817
+ description:
818
+ description: Describe la funcionalidad del permiso
819
+ type: string
820
+ method:
821
+ description: Tipo de HTTP REQUEST del permiso
822
+ type: string
823
+ example: GET
824
+ api:
825
+ description: ruta que accede a la función que utilice el permiso
826
+ type: string
827
+ example: "api.create"
828
+ endpoint:
829
+ description: path del permiso
830
+ type: string
831
+ example: "/api/permissions"
832
+ auth:
833
+ description: Identifica si para acceder al permiso necesita un token o es público
834
+ type: number
835
+ example: 1
836
+ _menu:
837
+ description: hace referencia a si el permiso pertenece a un menú en especifíco
838
+ type: string
839
+ format: ObjectId
840
+ example: "61b06de713a90b4d6dce7171"
841
+ required:
842
+ - description
843
+ - method
844
+ - api
845
+ - endpoint
846
+ - _menu
847
+ responses:
848
+ '201': # status code
849
+ description: retorna el resultado de la respuesta
850
+ get:
851
+ summary: Obtener todos los permisos
852
+ tags:
853
+ - permissions
854
+ description: Obtener todos los permisos
855
+ security:
856
+ - bearerAuth: []
857
+ responses:
858
+ '200': # status code
859
+ description: Retorna una lista de objetos JSON
860
+ /iam/permission/{PERMISSION_ID}:
861
+ get:
862
+ parameters:
863
+ - name: PERMISSION_ID
864
+ in: path
865
+ description: ID de un permiso que este registrado
866
+ required: true
867
+ schema:
868
+ type: string
869
+ format: ObjectId
870
+ summary: Obtener detalle del permiso
871
+ tags:
872
+ - permissions
873
+ description: Obtener detalle del permiso
874
+ security:
875
+ - bearerAuth: []
876
+ responses:
877
+ '200': # status code
878
+ description: Retorna un objeto JSON
879
+ patch:
880
+ parameters:
881
+ - name: PERMISSION_ID
882
+ in: path
883
+ description: ID de un permiso que este registrado
884
+ required: true
885
+ schema:
886
+ type: string
887
+ format: ObjectId
888
+ summary: Actualizar permiso
889
+ tags:
890
+ - permissions
891
+ description: Actualizar permiso
892
+ security:
893
+ - bearerAuth: []
894
+ requestBody:
895
+ content:
896
+ 'application/json':
897
+ schema:
898
+ properties:
899
+ description:
900
+ description: Describe la funcionalidad del permiso
901
+ type: string
902
+ method:
903
+ description: Tipo de HTTP REQUEST del permiso
904
+ type: string
905
+ example: GET
906
+ api:
907
+ description: ruta que accede a la función que utilice el permiso
908
+ type: string
909
+ example: "api.create"
910
+ endpoint:
911
+ description: path del permiso
912
+ type: string
913
+ example: "/api/permissions"
914
+ auth:
915
+ description: Identifica si para acceder al permiso necesita un token o es público
916
+ type: number
917
+ example: 1
918
+ _menu:
919
+ description: hace referencia a si el permiso pertenece a un menú en especifíco
920
+ type: string
921
+ format: ObjectId
922
+ example: "61b06de713a90b4d6dce7171"
923
+ responses:
924
+ '200': # status code
925
+ description: Retorna un objeto JSON de un permiso
926
+ delete:
927
+ parameters:
928
+ - name: PERMISSION_ID
929
+ in: path
930
+ description: ID de un permiso que este registrado
931
+ required: true
932
+ schema:
933
+ type: string
934
+ format: ObjectId
935
+ summary: Eliminar permiso
936
+ tags:
937
+ - permissions
938
+ description: Eliminar permiso
939
+ security:
940
+ - bearerAuth: []
941
+ responses:
942
+ '200': # status code
943
+ description: Ok
944
+ /iam/permission/{PERMISSION_ID}/status:
945
+ put:
946
+ parameters:
947
+ - name: PERMISSION_ID
948
+ in: path
949
+ description: ID de un permiso que este registrado
950
+ required: true
951
+ schema:
952
+ type: string
953
+ format: ObjectId
954
+ summary: Activar o desactivar permiso
955
+ tags:
956
+ - permissions
957
+ description: Activar o desactivar permiso
958
+ security:
959
+ - bearerAuth: []
960
+ requestBody:
961
+ content:
962
+ 'application/json':
963
+ schema:
964
+ properties:
965
+ status:
966
+ type: string
967
+ example: Activo
968
+ responses:
969
+ '200': # status code
970
+ description: Retorna el resultado de la respuesta
971
+ /iam/permission/count/all:
972
+ get:
973
+ summary: Obtiene el número de permisos
974
+ tags:
975
+ - permissions
976
+ description: Obtiene el número de permisos
977
+ security:
978
+ - bearerAuth: []
979
+ responses:
980
+ '200': # status code
981
+ description: Retorna el resultado de la respuesta
982
+ /iam/menu:
983
+ post:
984
+ summary: Crea un menú
985
+ tags:
986
+ - menús
987
+ description: Crea un menú
988
+ security:
989
+ - bearerAuth: []
990
+ requestBody:
991
+ content:
992
+ application/json:
993
+ schema:
994
+ properties:
995
+ label:
996
+ description: Nombre del Menú
997
+ type: string
998
+ example: "IAM"
999
+ path:
1000
+ description: Ruta de acceso al menú
1001
+ type: string
1002
+ example: "/dashboard/iam"
1003
+ icon:
1004
+ description: icono del menú
1005
+ type: string
1006
+ example: "mdi-shield-account"
1007
+ index:
1008
+ description: path del permiso
1009
+ type: number
1010
+ example: 1
1011
+ _menu:
1012
+ description: hace referencia a si el menú que se va a crear es un submenú de un menú ya registrado
1013
+ type: string
1014
+ format: ObjectId
1015
+ example: "61b06de713a90b4d6dce7171"
1016
+ required:
1017
+ - label
1018
+ - path
1019
+ - icon
1020
+ responses:
1021
+ '201': # status code
1022
+ description: retorna un objeto JSON
1023
+ get:
1024
+ summary: Obtiene todos los elementos de menú
1025
+ tags:
1026
+ - menús
1027
+ description: Obtiene todos los elementos de menú
1028
+ security:
1029
+ - bearerAuth: []
1030
+ responses:
1031
+ '200': # status code
1032
+ description: Retorna una lista de objetos JSON
1033
+ /iam/menu/{MENU_ID}:
1034
+ get:
1035
+ parameters:
1036
+ - name: MENU_ID
1037
+ in: path
1038
+ description: ID de un menú que este registrado
1039
+ required: true
1040
+ schema:
1041
+ type: string
1042
+ format: ObjectId
1043
+ summary: Obtiene el detalle de un elemento de menú
1044
+ tags:
1045
+ - menús
1046
+ description: Obtiene el detalle de un elemento de menú
1047
+ security:
1048
+ - bearerAuth: []
1049
+ responses:
1050
+ '200': # status code
1051
+ description: Retorna un objeto JSON
1052
+ patch:
1053
+ parameters:
1054
+ - name: MENU_ID
1055
+ in: path
1056
+ description: ID de un menú que este registrado
1057
+ required: true
1058
+ schema:
1059
+ type: string
1060
+ format: ObjectId
1061
+ summary: Actualiza un elemento de menú
1062
+ tags:
1063
+ - menús
1064
+ description: Actualiza un elemento de menú
1065
+ security:
1066
+ - bearerAuth: []
1067
+ requestBody:
1068
+ content:
1069
+ 'application/json':
1070
+ schema:
1071
+ properties:
1072
+ label:
1073
+ description: Nombre del Menú
1074
+ type: string
1075
+ example: "IAM"
1076
+ path:
1077
+ description: Ruta de acceso al menú
1078
+ type: string
1079
+ example: "/dashboard/iam"
1080
+ icon:
1081
+ description: icono del menú
1082
+ type: string
1083
+ example: "mdi-shield-account"
1084
+ index:
1085
+ description: path del permiso
1086
+ type: number
1087
+ example: 1
1088
+ _menu:
1089
+ description: hace referencia a si el menú que se va a crear es un submenú de un menú ya registrado
1090
+ type: string
1091
+ format: ObjectId
1092
+ example: "61b06de713a90b4d6dce7171"
1093
+ required:
1094
+ - label
1095
+ - path
1096
+ - icon
1097
+ responses:
1098
+ '200': # status code
1099
+ description: Retorna un objeto JSON
1100
+ delete:
1101
+ parameters:
1102
+ - name: MENU_ID
1103
+ in: path
1104
+ description: ID de un menú que este registrado
1105
+ required: true
1106
+ schema:
1107
+ type: string
1108
+ format: ObjectId
1109
+ summary: Elimina un elemento de menú
1110
+ tags:
1111
+ - menús
1112
+ description: Elimina un elemento de menú
1113
+ security:
1114
+ - bearerAuth: []
1115
+ responses:
1116
+ '200': # status code
1117
+ description: Ok
1118
+ /iam/menu/{MENU_ID}/status:
1119
+ put:
1120
+ parameters:
1121
+ - name: MENU_ID
1122
+ in: path
1123
+ description: ID de un menú que este registrado
1124
+ required: true
1125
+ schema:
1126
+ type: string
1127
+ format: ObjectId
1128
+ summary: Activa o desactiva un menú
1129
+ tags:
1130
+ - menús
1131
+ description: Activa o desactiva un menú
1132
+ security:
1133
+ - bearerAuth: []
1134
+ requestBody:
1135
+ content:
1136
+ application/json:
1137
+ schema:
1138
+ properties:
1139
+ status:
1140
+ type: string
1141
+ example: Activo
1142
+ responses:
1143
+ '200': # status code
1144
+ description: Retorna el resultado de la respuesta
1145
+ /iam/menu/count/all:
1146
+ get:
1147
+ summary: Obtiene el número de menús
1148
+ tags:
1149
+ - menús
1150
+ description: Obtiene el número de menús
1151
+ security:
1152
+ - bearerAuth: []
1153
+ responses:
1154
+ '200': # status code
1155
+ description: Retorna el resultado de la respuesta
1156
+ /iam/menu/order:
1157
+ post:
1158
+ summary: Ordena los elementos de menú
1159
+ tags:
1160
+ - menús
1161
+ description: Ordena los elementos de menú
1162
+ security:
1163
+ - bearerAuth: []
1164
+ requestBody:
1165
+ content:
1166
+ 'application/json':
1167
+ schema:
1168
+ properties:
1169
+ length:
1170
+ type: object
1171
+ properties:
1172
+ _id:
1173
+ type: string
1174
+ format: ObjectId
1175
+ example: 64bab1c64b2bce1394cc6491
1176
+ index:
1177
+ type: number
1178
+ example: 54
1179
+ responses:
1180
+ '200': # status code
1181
+ description: Retorna el resultado de la respuesta
1182
+ /iam/history:
1183
+ post:
1184
+ summary: Obtener todo el historial paginado
1185
+ tags:
1186
+ - History
1187
+ description: Ordena los elementos de menú
1188
+ security:
1189
+ - bearerAuth: []
1190
+ requestBody:
1191
+ content:
1192
+ 'application/json':
1193
+ schema:
1194
+ properties:
1195
+ filter:
1196
+ type: object
1197
+ properties:
1198
+ method:
1199
+ enum: [ GET, POST, PUT, PATCH, DELETE]
1200
+ description:
1201
+ type: string
1202
+ example: crear
1203
+ config:
1204
+ type: object
1205
+ properties:
1206
+ page:
1207
+ type: number
1208
+ example: 1
1209
+ itemsPerPage:
1210
+ type: number
1211
+ example: 10
1212
+ responses:
1213
+ '200': # status code
1214
+ description: Retorna el resultado de la respuesta
1215
+ /iam/history/{HISTORY_ID}:
1216
+ get:
1217
+ parameters:
1218
+ - name: HISTORY_ID
1219
+ in: path
1220
+ description: ID de un registro de historial
1221
+ required: true
1222
+ schema:
1223
+ type: string
1224
+ format: ObjectId
1225
+ tags:
1226
+ - History
1227
+ description: Detalle de u registro de historial
1228
+ security:
1229
+ - bearerAuth: []
1230
+ responses:
1231
+ '200': # status code
1232
1232
  description: Retorna un objeto