|
|
|
|
# Copyright 2016 OpenMarket Ltd
|
|
|
|
|
#
|
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
|
#
|
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
#
|
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
|
# limitations under the License.
|
|
|
|
|
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:
|
|
|
|
|
$ref: definitions/security.yaml
|
|
|
|
|
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
|
