API: registrar solicitudes para alta de usuarios
Hay que implementar una serie de recursos rest para tramitar el registro, validación y carga de una solicitud de registro.
- El primer paso, iniciar el registro proporcionando un email:
/registro
- POST
- body: {"email": "email@valido"}
- retorna: ID
- errors:
- 400 email incorrecto
- 500 error interno
- Se debe proporcionar el código verificador, recibido en el email, para confirmar la solicitud:
/registro/{ID}/verificar
- POST
- body: {"codigo": "CODIGO"}
- errors:
- 400 código incorrecto para la solicitud
- 404 no existe ID
- 500 error interno
- Se debe cargar los datos personales para completar la solicitud:
/registro/{ID}
- PUT
- body: **solicitud**
- errors:
- 400 datos incorrectos, retorna body indicando campos con error
- 404 no existe ID
- 406 el registro no ha sido verificado
- 500 error interno
solicitud:{
"nombre": "nombre",
"apellido": "apellido",
"documento": {"tipo": "DNI", "numero":"30619672"},
"sexo": "M",
"legajo": "1234",
"emails": [
{"email":"sergio@vier.com","uso":"personal"},
{"email":"sergio@unam","uso":"laboral"},
{"email":"otro@unam","uso":"laboral"}
],
"telefonos": [
{"numero": "123456789", "tipo": "celular", "uso":"personal"},
{"numero": "45789123", "interno":"210", "tipo": "fijo", "uso":"laboral"}
]
}
- Es posible consultar el estado de la solicitud:
/registro/{ID}
- GET
- retorna: **solicitud**
- errors:
- 404 no existe ID
- 500 error interno
solicitud:{
"estado":"aprobado"
"movimientos":[
{"fecha":"dd-mm-yyyy", "hora":"hh:ii:ss","operacion":"solicitud-creada"},
{"fecha":"dd-mm-yyyy", "hora":"hh:ii:ss","operacion":"solicitud-autorizada"}
{"fecha":"dd-mm-yyyy", "hora":"hh:ii:ss","operacion":"usuario-creado"}
{"fecha":"dd-mm-yyyy", "hora":"hh:ii:ss","operacion":"usuario-informado"}
]
}
Edited by Sergio Vier