mirror of
https://github.com/element-hq/synapse
synced 2024-09-12 03:35:10 +00:00
8fe912d95c
perl -pi -e 's#/matrix#/_matrix#g' ./cmdclient/console.py ./docs/client-server/howto.rst ./docs/client-server/specification.rst ./docs/client-server/swagger_matrix/directory ./docs/client-server/swagger_matrix/events ./docs/client-server/swagger_matrix/login ./docs/client-server/swagger_matrix/presence ./docs/client-server/swagger_matrix/profile ./docs/client-server/swagger_matrix/registration ./docs/client-server/swagger_matrix/rooms ./docs/server-server/specification.rst ./graph/graph.py ./jsfiddles/create_room_send_msg/demo.js ./jsfiddles/event_stream/demo.js ./jsfiddles/example_app/demo.js ./jsfiddles/register_login/demo.js ./jsfiddles/room_memberships/demo.js ./synapse/api/urls.py ./tests/federation/test_federation.py ./tests/handlers/test_presence.py ./tests/handlers/test_typing.py ./tests/rest/test_events.py ./tests/rest/test_presence.py ./tests/rest/test_profile.py ./tests/rest/test_rooms.py ./webclient/components/fileUpload/file-upload-service.js ./webclient/components/matrix/matrix-service.js
164 lines
4.4 KiB
Text
164 lines
4.4 KiB
Text
{
|
|
"apiVersion": "1.0.0",
|
|
"swaggerVersion": "1.2",
|
|
"basePath": "http://localhost:8080/_matrix/client/api/v1",
|
|
"resourcePath": "/presence",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"apis": [
|
|
{
|
|
"path": "/presence/{userId}/status",
|
|
"operations": [
|
|
{
|
|
"method": "PUT",
|
|
"summary": "Update this user's presence state.",
|
|
"notes": "This can only be done by the logged in user.",
|
|
"type": "void",
|
|
"nickname": "update_presence",
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"description": "The new presence state",
|
|
"required": true,
|
|
"type": "PresenceUpdate",
|
|
"paramType": "body"
|
|
},
|
|
{
|
|
"name": "userId",
|
|
"description": "The user whose presence to set.",
|
|
"required": true,
|
|
"type": "string",
|
|
"paramType": "path"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"method": "GET",
|
|
"summary": "Get this user's presence state.",
|
|
"notes": "Get this user's presence state.",
|
|
"type": "PresenceUpdate",
|
|
"nickname": "get_presence",
|
|
"parameters": [
|
|
{
|
|
"name": "userId",
|
|
"description": "The user whose presence to get.",
|
|
"required": true,
|
|
"type": "string",
|
|
"paramType": "path"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"path": "/presence/list/{userId}",
|
|
"operations": [
|
|
{
|
|
"method": "GET",
|
|
"summary": "Retrieve a list of presences for all of this user's friends.",
|
|
"notes": "",
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "Presence"
|
|
},
|
|
"nickname": "get_presence_list",
|
|
"parameters": [
|
|
{
|
|
"name": "userId",
|
|
"description": "The user whose presence list to get.",
|
|
"required": true,
|
|
"type": "string",
|
|
"paramType": "path"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"method": "POST",
|
|
"summary": "Add or remove users from this presence list.",
|
|
"notes": "Add or remove users from this presence list.",
|
|
"type": "void",
|
|
"nickname": "modify_presence_list",
|
|
"parameters": [
|
|
{
|
|
"name": "userId",
|
|
"description": "The user whose presence list is being modified.",
|
|
"required": true,
|
|
"type": "string",
|
|
"paramType": "path"
|
|
},
|
|
{
|
|
"name": "body",
|
|
"description": "The modifications to make to this presence list.",
|
|
"required": true,
|
|
"type": "PresenceListModifications",
|
|
"paramType": "body"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"models": {
|
|
"PresenceUpdate": {
|
|
"id": "PresenceUpdate",
|
|
"properties": {
|
|
"state": {
|
|
"type": "string",
|
|
"description": "Enum: The presence state.",
|
|
"enum": [
|
|
"offline",
|
|
"unavailable",
|
|
"online",
|
|
"free_for_chat"
|
|
]
|
|
},
|
|
"status_msg": {
|
|
"type": "string",
|
|
"description": "The user-defined message associated with this presence state."
|
|
}
|
|
},
|
|
"subTypes": [
|
|
"Presence"
|
|
]
|
|
},
|
|
"Presence": {
|
|
"id": "Presence",
|
|
"properties": {
|
|
"mtime_age": {
|
|
"type": "integer",
|
|
"format": "int64",
|
|
"description": "The last time this user's presence state changed, in milliseconds."
|
|
},
|
|
"user_id": {
|
|
"type": "string",
|
|
"description": "The fully qualified user ID"
|
|
}
|
|
}
|
|
},
|
|
"PresenceListModifications": {
|
|
"id": "PresenceListModifications",
|
|
"properties": {
|
|
"invite": {
|
|
"type": "array",
|
|
"description": "A list of user IDs to add to the list.",
|
|
"items": {
|
|
"type": "string",
|
|
"description": "A fully qualified user ID."
|
|
}
|
|
},
|
|
"drop": {
|
|
"type": "array",
|
|
"description": "A list of user IDs to remove from the list.",
|
|
"items": {
|
|
"type": "string",
|
|
"description": "A fully qualified user ID."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|