POST /users
POST /users.json -F "CAMPO1=valor1" -F "CAMPO2=valor2" -F "form[CAMPO3]=valor3" |
Crea el usuario con los campos indicados |
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 |
email |
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 |
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 |
Valor devuelto
Devuelve un vector de datos indicando el código de respuesta de la operación y el id del usuario creado.
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á siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo." -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á siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.","language":"es_ES","role":"Operador"},{"id":"1","login":"admin","descr":"Usuario Administrador","timeout":"1440","firstname":"","lastname":"","email":"","language":"es_ES","role":"Administrador maestro"}]