|
|
|
|
swagger: '2.0'
|
|
|
|
|
info:
|
|
|
|
|
title: "Matrix Client-Server Administration API"
|
|
|
|
|
version: "1.0.0"
|
|
|
|
|
host: localhost:8008
|
|
|
|
|
schemes:
|
|
|
|
|
- https
|
|
|
|
|
- http
|
|
|
|
|
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
|
|
|
|
|
consumes:
|
|
|
|
|
- application/json
|
|
|
|
|
produces:
|
|
|
|
|
- application/json
|
|
|
|
|
securityDefinitions:
|
|
|
|
|
accessToken:
|
|
|
|
|
type: apiKey
|
|
|
|
|
description: The user_id or application service access_token
|
|
|
|
|
name: access_token
|
|
|
|
|
in: query
|
|
|
|
|
paths:
|
|
|
|
|
"/admin/whois/{userId}":
|
|
|
|
|
get:
|
|
|
|
|
summary: Gets information about a particular user.
|
|
|
|
|
description: |-
|
|
|
|
|
Gets information about a particular user.
|
|
|
|
|
|
|
|
|
|
This API may be restricted to only be called by the user being looked
|
|
|
|
|
up, or by a server admin. Server-local administrator privileges are not
|
|
|
|
|
specified in this document.
|
|
|
|
|
security:
|
|
|
|
|
- accessToken: []
|
|
|
|
|
parameters:
|
|
|
|
|
- in: path
|
|
|
|
|
type: string
|
|
|
|
|
name: userId
|
|
|
|
|
description: The user to look up.
|
|
|
|
|
required: true
|
|
|
|
|
x-example: "@peter:rabbit.rocks"
|
|
|
|
|
responses:
|
|
|
|
|
200:
|
|
|
|
|
description: The lookup was successful.
|
|
|
|
|
examples:
|
|
|
|
|
application/json: |-
|
|
|
|
|
{
|
|
|
|
|
"user_id": "@peter:rabbit.rocks",
|
|
|
|
|
"devices": {
|
|
|
|
|
"teapot": {
|
|
|
|
|
"sessions": [
|
|
|
|
|
{
|
|
|
|
|
"connections": [
|
|
|
|
|
{
|
|
|
|
|
"ip": "127.0.0.1",
|
|
|
|
|
"last_seen": 1411996332123,
|
|
|
|
|
"user_agent": "curl/7.31.0-DEV"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"ip": "10.0.0.2",
|
|
|
|
|
"last_seen": 1411996332123,
|
|
|
|
|
"user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/37.0.2062.120 Safari/537.36"
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
user_id:
|
|
|
|
|
type: string
|
|
|
|
|
description: The Matrix user ID of the user.
|
|
|
|
|
devices:
|
|
|
|
|
type: object
|
|
|
|
|
description: |-
|
|
|
|
|
Each key is an identitfier for one of the user's devices.
|
|
|
|
|
additionalProperties:
|
|
|
|
|
type: object
|
|
|
|
|
title: DeviceInfo
|
|
|
|
|
properties:
|
|
|
|
|
sessions:
|
|
|
|
|
type: array
|
|
|
|
|
description: A user's sessions (i.e. what they did with an access token from one login).
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
title: SessionInfo
|
|
|
|
|
properties:
|
|
|
|
|
connections:
|
|
|
|
|
type: array
|
|
|
|
|
description: Information particular connections in the session.
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
title: ConnectionInfo
|
|
|
|
|
properties:
|
|
|
|
|
ip:
|
|
|
|
|
type: string
|
|
|
|
|
description: Most recently seen IP address of the session.
|
|
|
|
|
last_seen:
|
|
|
|
|
type: number
|
|
|
|
|
description: Unix timestamp that the session was last active.
|
|
|
|
|
user_agent:
|
|
|
|
|
type: string
|
|
|
|
|
description: User agent string last seen in the session.
|
|
|
|
|
tags:
|
|
|
|
|
- Server administration
|
