User management API

User management API provides basic means for users management.
More information: https://black32167.github.io/social_api
Contact Info: none@nowhere
Version: 0.0.1
BasePath:/v1
MIT license
https://opensource.org/licenses/MIT

Access

Methods

[ Jump to Models ]

Table of Contents

User

User

Up
post /user
Creates user (createUser)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

User User (required)
Body Parameter

Return type

User

Example data

Content-Type: application/json
{
  "name" : "John"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

201

Created User

Up
get /user/{userName}
Returns a user. (getUser)

Path parameters

userName (required)
Path Parameter — user identifier default: null

Return type

User

Example data

Content-Type: application/json
{
  "name" : "John"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

user User

Up
get /user
Returns a list of users. (getUsers)

Return type

Users

Example data

Content-Type: application/json
{
  "items" : [ {
    "name" : "John"
  }, {
    "name" : "Jane"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

list of users Users

Up
post /user/{userName}/credentials
Sets credentials (setCredentials)

Path parameters

userName (required)
Path Parameter — user identifier default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

UserCredentials UserCredentials (required)
Body Parameter

Responses

204

no content

Up
post /user/validate
Validates credentials (validate)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

UserAuth UserAuth (required)
Body Parameter

Return type

ValidationResult

Example data

Content-Type: application/json
{
  "valid" : true,
  "userName" : "userName"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

validation result ValidationResult

Models

[ Jump to Methods ]

Table of Contents

  1. User -
  2. UserAuth -
  3. UserCredentials -
  4. Users -
  5. ValidationResult -

User - Up

name (optional)

UserAuth - Up

authToken (optional)

UserCredentials - Up

password (optional)

Users - Up

users (optional)

ValidationResult - Up

valid (optional)
userName (optional)