Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Orion/Server API/User API"
< Orion | Server API
(→Creating users) |
(→Getting a user) |
||
Line 29: | Line 29: | ||
}} | }} | ||
− | === | + | === Read a user === |
+ | |||
+ | {{Orion/ServerAPI | ||
+ | | method = GET | ||
+ | | overview = To read a user account profile, send a GET request. | ||
+ | | reqhead = /users/newuser HTTP/1.1 | ||
+ | Orion-Version: 1.0 | ||
+ | | resphead = 200 OK | ||
+ | Content-Type: application/json | ||
+ | | respbody = | ||
+ | { | ||
+ | "EmailConfirmed": false, | ||
+ | "FullName": "New User", | ||
+ | "HasPassword": true, | ||
+ | "Location": "/users/newuser", | ||
+ | "UserName": "newuser" | ||
+ | } | ||
+ | | explain = The request needs to be authenticated as newuser or an admin user. | ||
+ | }} | ||
=== Updating a user === | === Updating a user === |
Revision as of 19:29, 19 November 2014
The User API is a web server API for browsing and manipulating users.
Contents
Actions on users
Create a user
- Overview
- To create a new user account, send a POST request with the UserName and Password.
- HTTP Method
- POST
- Example Request
POST /users HTTP/1.1
Orion-Version: 1.0
Content-Type: application/json
{
"UserName" : "newuser",
"Password" : "newPassw0rd"
"FullName": "New User",
}
- Example Response
HTTP/1.1 201 CREATED
Content-Type: application/json
{
"EmailConfirmed": false,
"FullName": "New User",
"HasPassword": true,
"Location": "/users/newuser",
"UserName": "newuser"
}
- Detailed Explanation
- FullName and Email are optional fields that can be added to the request. The request does not need to be authenticated unless the server specifies the orion.auth.user.creation preference to allow only the admin user to create accounts.
Read a user
- Overview
- To read a user account profile, send a GET request.
- HTTP Method
- GET
- Example Request
GET /users/newuser HTTP/1.1
Orion-Version: 1.0
- Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"EmailConfirmed": false,
"FullName": "New User",
"HasPassword": true,
"Location": "/users/newuser",
"UserName": "newuser"
}
- Detailed Explanation
- The request needs to be authenticated as newuser or an admin user.