POST /users
Permite crear usuarios en el sistema CNM.
POST /users.json -F "CAMPO1=valor1" -F "CAMPO2=valor2" -F "form[CAMPO3]=valor3" | Crea el usuario con los campos indicados |
1. Campos
Nombre | Tipo | Valores posibles | Obligatorio | Descripción |
---|---|---|---|---|
login | Texto | Cualquiera | Si | Login del usuario |
passwd | Texto | Cualquiera | Si | Contraseña no cifrada del usuario |
descr | Texto | Cualquiera | No | Descripción del usuario |
timeout | Entero | Cualquiera | No | Timeout de sesión del usuario |
firstname | Texto | Cualquiera | Si | Nombre del usuario |
lastname | Texto | Cualquiera | Si | Apellidos del usuario |
Texto | Cualquiera | Si | Correo electrónico del usuario | |
language | Texto | es_ES | en_US | No | Idioma de la interfaz gráfica del usuario |
profile | Texto | Cualquiera | Si | Perfil al que pertenece el usuario |
role | Texto | Cualquiera | Si | Rol del usuario |
2. Códigos de respuesta
Código | Descripción |
---|---|
200 | Resultado correcto |
400 | Error en la petición. |
401 | Error de autenticación. |
403 | Error por falta de permisos. |
500 | Error interno del servidor |
3. Valor devuelto
Devuelve un vector de datos indicando el código de respuesta de la operación y el id del usuario creado.
4.
5. Ejemplos
root@cnm:/var/www/html/onm/inc# curl -ki "https://localhost/onm/api/1.0/auth/token.json?u=admin&p=cnm123"HTTP/1.1 200 OK Date: Mon, 22 Sep 2014 09:41:38 GMT Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1 mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1 X-Powered-By: PHP/5.3.3-7 Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache : Vary: Accept-Encoding Content-Length: 59 Content-Type: text/html; charset=utf-8 {"status":0,"sessionid":"54ab68c03d7de23981bf2159dba068c3"} root@cnm:/var/www/html/onm/inc# curl -ki -g -H "Authorization: 54ab68c03d7de23981bf2159dba068c3" -X GET "https://localhost/onm/api/1.0/users.json" HTTP/1.1 200 OK Date: Mon, 22 Sep 2014 09:41:51 GMT Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1 mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1 X-Powered-By: PHP/5.3.3-7 Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache : Vary: Accept-Encoding Content-Length: 167 Content-Type: text/html; charset=utf-8 [{"id":"1","login":"admin","descr":"Usuario Administrador","timeout":"1440","firstname":"","lastname":"","email":"","language":"es_ES","role":"Administrador maestro"}] root@cnm:/var/www/html/onm/inc# curl -ki -H "Authorization: 54ab68c03d7de23981bf2159dba068c3" -X POST "https://localhost/onm/api/1.0/users.json" -F "login=test" -F "passwd=test1234" -F "descr=Usuario de prueba" -F "timeout=1000" -F "firstname=Usuario" -F "lastname=De Prueba" -F "email= Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. " -F "language=en_US" -F "profile=Test" -F "role=Operador" HTTP/1.1 100 Continue HTTP/1.1 200 OK Date: Mon, 22 Sep 2014 09:42:01 GMT Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1 mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1 X-Powered-By: PHP/5.3.3-7 Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache : Vary: Accept-Encoding Content-Length: 28 Content-Type: text/html; charset=utf-8 {"rc":0,"rcstr":"","id":"2"} root@cnm:/var/www/html/onm/inc# curl -ki -g -H "Authorization: 54ab68c03d7de23981bf2159dba068c3" -X GET "https://localhost/onm/api/1.0/users.json" HTTP/1.1 200 OK Date: Mon, 22 Sep 2014 09:42:06 GMT Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1 mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1 X-Powered-By: PHP/5.3.3-7 Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache : Vary: Accept-Encoding Content-Length: 358 Content-Type: text/html; charset=utf-8 [{"id":"2","login":"test","descr":"Usuario de prueba","timeout":"1000","firstname":"Usuario","lastname":"De Prueba","email":" Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. ","language":"es_ES","role":"Operador"},{"id":"1","login":"admin","descr":"Usuario Administrador","timeout":"1440","firstname":"","lastname":"","email":"","language":"es_ES","role":"Administrador maestro"}] |