aurora
/
nextcloud-neon
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

spec_templates,specs: Cleanup and fix

pull/61/head
jld3103 2 years ago
parent
054f258aa9
commit
3478b92efa
No known key found for this signature in database
GPG Key ID: 9062417B9E8EB7B3
15 changed files with 1347 additions and 513 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 61
      packages/spec_templates/bin/generate.dart
  2. 68
      packages/spec_templates/lib/openapi_spec.dart
  3. 32
      specs/common.json
  4. 90
      specs/core.json
  5. 131
      specs/news.json
  6. 80
      specs/notes.json
  7. 96
      specs/notifications.json
  8. 57
      specs/provisioning_api.json
  9. 275
      specs/templates/core.json
  10. 397
      specs/templates/news.json
  11. 127
      specs/templates/notes.json
  12. 64
      specs/templates/notifications.json
  13. 153
      specs/templates/provisioning_api.json
  14. 57
      specs/templates/user_status.json
  15. 144
      specs/user_status.json

61
packages/spec_templates/bin/generate.dart
Unescape View File

@ -81,13 +81,11 @@ Future main(final List<String> args) async {
if (url.endsWith('/')) { if (url.endsWith('/')) {
url = url.substring(0, url.length - 1); url = url.substring(0, url.length - 1);
} }
if (hasRoutes && hasOCS) {
if (k == 'routes') { if (k == 'routes') {
url = '$routesBasePath$url'; url = '$routesBasePath$url';
} else if (k == 'ocs') { } else if (k == 'ocs') {
url = '$ocsBasePath$url'; url = '$ocsBasePath$url';
} }
}
final verb = route['verb'] as String? ?? 'GET'; final verb = route['verb'] as String? ?? 'GET';
if (name.startsWith('page#') || name.startsWith('admin#')) { if (name.startsWith('page#') || name.startsWith('admin#')) {
@ -218,22 +216,10 @@ Future main(final List<String> args) async {
parameters: parameters, parameters: parameters,
); );
} }
/*
for (final bodyParameter in queryParameters) ...{
bodyParameter.name: {
if (bodyParameter.description != null) ...{
'description': bodyParameter.description,
},
'type': bodyParameter.openAPIType ?? 'TODO',
if (bodyParameter.defaultValue != null) ...{
'default': bodyParameter.defaultValue,
},
}
},
*/
final operation = Operation( final operation = Operation(
operationID: '${name.replaceAll('#', '-').toLowerCase()}-TODO', operationID: '${name.replaceAll('#', '-').toLowerCase()}-TODO',
tags: [id],
parameters: queryParameters.isNotEmpty parameters: queryParameters.isNotEmpty
? queryParameters ? queryParameters
.map<Parameter>( .map<Parameter>(
@ -242,7 +228,16 @@ Future main(final List<String> args) async {
in_: 'query', in_: 'query',
description: queryParameter.description, description: queryParameter.description,
required: !queryParameter.nullable && queryParameter.defaultValue == null, required: !queryParameter.nullable && queryParameter.defaultValue == null,
schema: { schema: queryParameter.openAPIType == 'boolean'
? {
// This is a quirk in Nextcloud where sending literal booleans in query parameters doesn't work and only integers work.
// See https://github.com/nextcloud/server/issues/34226
'type': 'integer',
if (queryParameter.defaultValue != null) ...{
'default': queryParameter.defaultValue == 'true' ? 1 : 0,
},
}
: {
'type': queryParameter.openAPIType ?? 'TODO', 'type': queryParameter.openAPIType ?? 'TODO',
if (queryParameter.defaultValue != null) ...{ if (queryParameter.defaultValue != null) ...{
'default': queryParameter.defaultValue, 'default': queryParameter.defaultValue,
@ -291,6 +286,15 @@ Future main(final List<String> args) async {
} }
} }
late String spdxIdentifier;
switch (license) {
case 'agpl':
spdxIdentifier = ' AGPL-3.0';
break;
default:
throw Exception('Can not convert license name "$license" to a SPDX identifier');
}
File( File(
p.join( p.join(
'specs', 'specs',
@ -300,36 +304,17 @@ Future main(final List<String> args) async {
).writeAsStringSync( ).writeAsStringSync(
const JsonEncoder.withIndent(' ').convert( const JsonEncoder.withIndent(' ').convert(
Spec( Spec(
version: '3.0.3', version: '3.1.0',
info: Info( info: Info(
title: name, title: name,
version: version, version: version,
description: summary, description: summary,
license: License( license: License(
name: license, name: license,
identifier: spdxIdentifier,
), ),
), ),
servers: [ tags: [id],
Server(
url:
'https://{hostname}:{port}${isCore || (hasRoutes && hasOCS) ? '' : hasOCS ? ocsBasePath : routesBasePath}',
variables: {
'hostname': ServerVariable(default_: 'localhost'),
'port': ServerVariable(default_: '8080'),
},
)
],
security: [
{'basic_auth': []},
],
components: Components(
securitySchemes: {
'basic_auth': SecurityScheme(
type: 'http',
scheme: 'basic',
),
},
),
paths: paths, paths: paths,
).toMap(), ).toMap(),
), ),

68
packages/spec_templates/lib/openapi_spec.dart
Unescape View File

@ -4,27 +4,21 @@ class Spec {
Spec({ Spec({
required this.version, required this.version,
required this.info, required this.info,
required this.tags,
required this.paths, required this.paths,
this.servers,
this.security,
this.components,
}); });
Map<String, dynamic> toMap() => { Map<String, dynamic> toMap() => {
'openapi': version, 'openapi': version,
'info': info.toMap(), 'info': info.toMap(),
if (servers != null) 'servers': servers!.map((final s) => s.toMap()).toList(), 'tags': tags.map((final tag) => <String, String>{'name': tag}).toList(),
if (security != null) 'security': security!,
if (components != null) 'components': components!.toMap(),
'paths': paths.map((final key, final value) => MapEntry(key, value.toMap())), 'paths': paths.map((final key, final value) => MapEntry(key, value.toMap())),
}; };
final String version; final String version;
final Info info; final Info info;
final List<String> tags;
final Map<String, Path> paths; final Map<String, Path> paths;
final List<Server>? servers;
final Components? components;
final List<Map<String, List>>? security;
} }
class Info { class Info {
@ -51,15 +45,21 @@ class Info {
class License { class License {
License({ License({
required this.name, required this.name,
this.identifier,
this.url, this.url,
}); }) : assert(
(identifier == null) != (url == null),
'Specify either identifier or url',
);
Map<String, dynamic> toMap() => { Map<String, dynamic> toMap() => {
'name': name, 'name': name,
if (identifier != null) 'identifier': identifier,
if (url != null) 'url': url, if (url != null) 'url': url,
}; };
final String name; final String name;
final String? identifier;
final String? url; final String? url;
} }
@ -183,29 +183,36 @@ class Parameter {
class Operation { class Operation {
Operation({ Operation({
required this.responses,
this.parameters,
this.operationID, this.operationID,
this.tags,
this.parameters,
this.responses,
}); });
Map<String, dynamic> toMap() => { Map<String, dynamic> toMap() => {
if (operationID != null) ...{ if (operationID != null) ...{
'operationId': operationID, 'operationId': operationID,
}, },
if (tags != null) ...{
'tags': tags,
},
if (parameters != null) ...{ if (parameters != null) ...{
'parameters': parameters!.map((final p) => p.toMap()).toList(), 'parameters': parameters!.map((final p) => p.toMap()).toList(),
}, },
'responses': responses.map( if (responses != null) ...{
'responses': responses!.map(
(final key, final value) => MapEntry( (final key, final value) => MapEntry(
key.toString(), key.toString(),
value.toMap(), value.toMap(),
), ),
), ),
},
}; };
final Map<dynamic, Response> responses;
final List<Parameter>? parameters;
final String? operationID; final String? operationID;
final List<String>? tags;
final List<Parameter>? parameters;
final Map<dynamic, Response>? responses;
} }
class Response { class Response {
@ -240,34 +247,3 @@ class MediaType {
final Map<String, dynamic>? schema; final Map<String, dynamic>? schema;
} }
class Components {
Components({
this.securitySchemes,
});
Map<String, dynamic> toMap() => {
if (securitySchemes != null)
'securitySchemes': securitySchemes!.map((final key, final value) => MapEntry(key, value.toMap()))
};
final Map<String, SecurityScheme>? securitySchemes;
}
class SecurityScheme {
SecurityScheme({
required this.type,
required this.scheme,
this.description,
});
Map<String, dynamic> toMap() => {
'type': type,
'scheme': scheme,
if (description != null) 'description': description,
};
final String type;
final String scheme;
final String? description;
}

32
specs/common.json
Unescape View File

@ -1,32 +0,0 @@
{
"openapi": "3.0.3",
"info": {
"title": "Common",
"version": "0.0.1"
},
"paths": {},
"components": {
"schemas": {
"OCSMeta": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "integer"
},
"itemsperpage": {
"type": "integer"
}
}
}
}
}
}

90
specs/core.json
Unescape View File

@ -1,11 +1,12 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Core", "title": "Core",
"version": "24.0.5", "version": "24.0.5",
"description": "Core functionality of Nextcloud", "description": "Core functionality of Nextcloud",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
@ -26,17 +27,32 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "core"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"OCSMeta": { "OCSMeta": {
"deprecated": true, "type": "object",
"description": "Stub" "properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}, },
"CoreServerStatus": { "CoreServerStatus": {
"type": "object", "type": "object",
@ -677,8 +693,15 @@
"type": "string" "type": "string"
}, },
"order": { "order": {
"type": "object", "description": "Should always be an integer, but there is a bug. See https://github.com/nextcloud/server/issues/32828",
"description": "Can either be a string or integer, see bug report https://github.com/nextcloud/server/issues/32828" "oneOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}, },
"href": { "href": {
"type": "string" "type": "string"
@ -741,12 +764,21 @@
} }
} }
} }
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
} }
}, },
"paths": { "paths": {
"/status.php": { "/status.php": {
"get": { "get": {
"operationId": "get-status", "operationId": "get-status",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "Status of the Nextcloud instance", "description": "Status of the Nextcloud instance",
@ -764,6 +796,9 @@
"/ocs/v1.php/cloud/capabilities": { "/ocs/v1.php/cloud/capabilities": {
"get": { "get": {
"operationId": "get-capabilities", "operationId": "get-capabilities",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "Capabilities of the Nextcloud instance", "description": "Capabilities of the Nextcloud instance",
@ -781,6 +816,9 @@
"/ocs/v1.php/core/navigation/apps": { "/ocs/v1.php/core/navigation/apps": {
"get": { "get": {
"operationId": "get-navigation-apps", "operationId": "get-navigation-apps",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "Navigation apps of the Nextcloud instance", "description": "Navigation apps of the Nextcloud instance",
@ -798,6 +836,9 @@
"/login/v2": { "/login/v2": {
"post": { "post": {
"operationId": "init-login-flow", "operationId": "init-login-flow",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "Login flow init", "description": "Login flow init",
@ -815,6 +856,9 @@
"/login/v2/poll": { "/login/v2/poll": {
"post": { "post": {
"operationId": "get-login-flow-result", "operationId": "get-login-flow-result",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "token", "name": "token",
@ -873,8 +917,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
}, },
{ {
@ -882,8 +926,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": true "default": 1
} }
}, },
{ {
@ -898,13 +942,17 @@
], ],
"get": { "get": {
"operationId": "get-preview", "operationId": "get-preview",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "Preview image of a file", "description": "Preview image of a file",
"content": { "content": {
"image/png": { "image/png": {
"schema": { "schema": {
"type": "string" "type": "string",
"format": "binary"
} }
} }
} }
@ -933,13 +981,17 @@
], ],
"get": { "get": {
"operationId": "get-avatar", "operationId": "get-avatar",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
"content": { "content": {
"application/json": { "image/png": {
"schema": { "schema": {
"type": "string" "type": "string",
"format": "binary"
} }
} }
} }

131
specs/news.json
Unescape View File

@ -1,16 +1,17 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "News", "title": "News",
"version": "18.1.1", "version": "18.1.1",
"description": "An RSS/Atom feed reader", "description": "An RSS/Atom feed reader",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
{ {
"url": "https://{hostname}:{port}/apps/news", "url": "https://{hostname}:{port}",
"variables": { "variables": {
"hostname": { "hostname": {
"default": "localhost" "default": "localhost"
@ -26,13 +27,12 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "news"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"NewsListFeeds": { "NewsListFeeds": {
"type": "object", "type": "object",
@ -206,13 +206,42 @@
} }
} }
} }
},
"OCSMeta": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
} }
} }
}, },
"paths": { "paths": {
"/api/v1-2/folders": { "/apps/news/api/v1-2/folders": {
"get": { "get": {
"operationId": "list-folders", "operationId": "list-folders",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -228,6 +257,9 @@
}, },
"post": { "post": {
"operationId": "create-folder", "operationId": "create-folder",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "name", "name": "name",
@ -252,7 +284,7 @@
} }
} }
}, },
"/api/v1-2/folders/{folderId}": { "/apps/news/api/v1-2/folders/{folderId}": {
"parameters": [ "parameters": [
{ {
"name": "folderId", "name": "folderId",
@ -265,6 +297,9 @@
], ],
"put": { "put": {
"operationId": "rename-folder", "operationId": "rename-folder",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "name", "name": "name",
@ -283,6 +318,9 @@
}, },
"delete": { "delete": {
"operationId": "delete-folder", "operationId": "delete-folder",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -290,7 +328,7 @@
} }
} }
}, },
"/api/v1-2/folders/{folderId}/read": { "/apps/news/api/v1-2/folders/{folderId}/read": {
"parameters": [ "parameters": [
{ {
"name": "folderId", "name": "folderId",
@ -304,6 +342,9 @@
], ],
"put": { "put": {
"operationId": "mark-folder-as-read", "operationId": "mark-folder-as-read",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "newestItemId", "name": "newestItemId",
@ -322,9 +363,12 @@
} }
} }
}, },
"/api/v1-2/feeds": { "/apps/news/api/v1-2/feeds": {
"get": { "get": {
"operationId": "list-feeds", "operationId": "list-feeds",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -340,6 +384,9 @@
}, },
"post": { "post": {
"operationId": "add-feed", "operationId": "add-feed",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "url", "name": "url",
@ -372,7 +419,7 @@
} }
} }
}, },
"/api/v1-2/feeds/{feedId}": { "/apps/news/api/v1-2/feeds/{feedId}": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -385,6 +432,9 @@
], ],
"delete": { "delete": {
"operationId": "delete-feed", "operationId": "delete-feed",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -392,7 +442,7 @@
} }
} }
}, },
"/api/v1-2/feeds/{feedId}/move": { "/apps/news/api/v1-2/feeds/{feedId}/move": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -405,6 +455,9 @@
], ],
"put": { "put": {
"operationId": "move-feed", "operationId": "move-feed",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "folderId", "name": "folderId",
@ -422,7 +475,7 @@
} }
} }
}, },
"/api/v1-2/feeds/{feedId}/rename": { "/apps/news/api/v1-2/feeds/{feedId}/rename": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -435,6 +488,9 @@
], ],
"put": { "put": {
"operationId": "rename-feed", "operationId": "rename-feed",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "feedTitle", "name": "feedTitle",
@ -452,7 +508,7 @@
} }
} }
}, },
"/api/v1-2/feeds/{feedId}/read": { "/apps/news/api/v1-2/feeds/{feedId}/read": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -465,6 +521,9 @@
], ],
"put": { "put": {
"operationId": "mark-feed-as-read", "operationId": "mark-feed-as-read",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "newestItemId", "name": "newestItemId",
@ -482,9 +541,12 @@
} }
} }
}, },
"/api/v1-2/items": { "/apps/news/api/v1-2/items": {
"get": { "get": {
"operationId": "list-articles", "operationId": "list-articles",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "type", "name": "type",
@ -509,8 +571,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": true "default": 1
} }
}, },
{ {
@ -536,8 +598,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
} }
], ],
@ -555,9 +617,12 @@
} }
} }
}, },
"/api/v1-2/items/updated": { "/apps/news/api/v1-2/items/updated": {
"get": { "get": {
"operationId": "list-updated-articles", "operationId": "list-updated-articles",
"tags": [
"news"
],
"parameters": [ "parameters": [
{ {
"name": "type", "name": "type",
@ -601,7 +666,7 @@
} }
} }
}, },
"/api/v1-2/items/{itemId}/read": { "/apps/news/api/v1-2/items/{itemId}/read": {
"parameters": [ "parameters": [
{ {
"name": "itemId", "name": "itemId",
@ -614,6 +679,9 @@
], ],
"put": { "put": {
"operationId": "mark-article-as-read", "operationId": "mark-article-as-read",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -621,7 +689,7 @@
} }
} }
}, },
"/api/v1-2/items/{itemId}/unread": { "/apps/news/api/v1-2/items/{itemId}/unread": {
"parameters": [ "parameters": [
{ {
"name": "itemId", "name": "itemId",
@ -634,6 +702,9 @@
], ],
"put": { "put": {
"operationId": "mark-article-as-unread", "operationId": "mark-article-as-unread",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -641,7 +712,7 @@
} }
} }
}, },
"/api/v1-2/items/{feedId}/{guidHash}/star": { "/apps/news/api/v1-2/items/{feedId}/{guidHash}/star": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -662,6 +733,9 @@
], ],
"put": { "put": {
"operationId": "star-article", "operationId": "star-article",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -669,7 +743,7 @@
} }
} }
}, },
"/api/v1-2/items/{feedId}/{guidHash}/unstar": { "/apps/news/api/v1-2/items/{feedId}/{guidHash}/unstar": {
"parameters": [ "parameters": [
{ {
"name": "feedId", "name": "feedId",
@ -690,6 +764,9 @@
], ],
"put": { "put": {
"operationId": "unstar-article", "operationId": "unstar-article",
"tags": [
"news"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""

80
specs/notes.json
Unescape View File

@ -1,16 +1,17 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Notes", "title": "Notes",
"version": "4.5.1", "version": "4.5.1",
"description": "Distraction-free notes and writing", "description": "Distraction-free notes and writing",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
{ {
"url": "https://{hostname}:{port}/apps/notes", "url": "https://{hostname}:{port}",
"variables": { "variables": {
"hostname": { "hostname": {
"default": "localhost" "default": "localhost"
@ -26,13 +27,12 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "notes"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"NotesNote": { "NotesNote": {
"type": "object", "type": "object",
@ -86,13 +86,42 @@
] ]
} }
} }
},
"OCSMeta": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
} }
} }
}, },
"paths": { "paths": {
"/api/v1/notes": { "/apps/notes/api/v1/notes": {
"get": { "get": {
"operationId": "get-notes", "operationId": "get-notes",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "category", "name": "category",
@ -163,6 +192,9 @@
}, },
"post": { "post": {
"operationId": "create-note", "operationId": "create-note",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "category", "name": "category",
@ -205,8 +237,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
} }
], ],
@ -224,7 +256,7 @@
} }
} }
}, },
"/api/v1/notes/{id}": { "/apps/notes/api/v1/notes/{id}": {
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -236,6 +268,10 @@
} }
], ],
"get": { "get": {
"operationId": "get-note",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "exclude", "name": "exclude",
@ -254,7 +290,6 @@
} }
} }
], ],
"operationId": "get-note",
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -270,6 +305,9 @@
}, },
"put": { "put": {
"operationId": "update-note", "operationId": "update-note",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "content", "name": "content",
@ -308,7 +346,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean" "type": "integer",
"default": 0
} }
}, },
{ {
@ -334,6 +373,9 @@
}, },
"delete": { "delete": {
"operationId": "delete-note", "operationId": "delete-note",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -348,9 +390,12 @@
} }
} }
}, },
"/api/v1/settings": { "/apps/notes/api/v1/settings": {
"get": { "get": {
"operationId": "get-settings", "operationId": "get-settings",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -366,6 +411,9 @@
}, },
"put": { "put": {
"operationId": "update-settings", "operationId": "update-settings",
"tags": [
"notes"
],
"requestBody": { "requestBody": {
"required": true, "required": true,
"content": { "content": {

96
specs/notifications.json
Unescape View File

@ -1,16 +1,17 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Notifications", "title": "Notifications",
"version": "2.12.1", "version": "2.12.1",
"description": "This app provides a backend and frontend for the notification API available in Nextcloud.", "description": "This app provides a backend and frontend for the notification API available in Nextcloud.",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
{ {
"url": "https://{hostname}:{port}/ocs/v1.php/apps/notifications", "url": "https://{hostname}:{port}",
"variables": { "variables": {
"hostname": { "hostname": {
"default": "localhost" "default": "localhost"
@ -26,17 +27,32 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "notifications"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"OCSMeta": { "OCSMeta": {
"deprecated": true, "type": "object",
"description": "Stub" "properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}, },
"NotificationsEmpty": { "NotificationsEmpty": {
"type": "object", "type": "object",
@ -181,6 +197,9 @@
}, },
"signature": { "signature": {
"type": "string" "type": "string"
},
"message": {
"type": "string"
} }
} }
}, },
@ -200,6 +219,23 @@
} }
} }
}, },
"NotificationsPushNotification": {
"type": "object",
"properties": {
"accountID": {
"type": "string"
},
"priority": {
"type": "string"
},
"type": {
"type": "string"
},
"subject": {
"$ref": "#/components/schemas/NotificationsPushNotificationDecryptedSubject"
}
}
},
"NotificationsPushNotificationDecryptedSubject": { "NotificationsPushNotificationDecryptedSubject": {
"type": "object", "type": "object",
"properties": { "properties": {
@ -226,12 +262,21 @@
} }
} }
} }
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
} }
}, },
"paths": { "paths": {
"/api/v2/notifications": { "/ocs/v1.php/apps/notifications/api/v2/notifications": {
"get": { "get": {
"operationId": "list-notifications", "operationId": "list-notifications",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -247,6 +292,9 @@
}, },
"delete": { "delete": {
"operationId": "delete-all-notifications", "operationId": "delete-all-notifications",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -261,7 +309,7 @@
} }
} }
}, },
"/api/v2/notifications/{id}": { "/ocs/v1.php/apps/notifications/api/v2/notifications/{id}": {
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -274,6 +322,9 @@
], ],
"get": { "get": {
"operationId": "get-notification", "operationId": "get-notification",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -289,6 +340,9 @@
}, },
"delete": { "delete": {
"operationId": "delete-notification", "operationId": "delete-notification",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -303,9 +357,12 @@
} }
} }
}, },
"/api/v2/push": { "/ocs/v1.php/apps/notifications/api/v2/push": {
"post": { "post": {
"operationId": "register-device", "operationId": "register-device",
"tags": [
"notifications"
],
"parameters": [ "parameters": [
{ {
"name": "pushTokenHash", "name": "pushTokenHash",
@ -329,7 +386,8 @@
"required": true, "required": true,
"schema": { "schema": {
"type": "string" "type": "string"
} },
"description": "This URL has to end with a / otherwise the device will not be able to register"
} }
], ],
"responses": { "responses": {
@ -347,6 +405,9 @@
}, },
"delete": { "delete": {
"operationId": "remove-device", "operationId": "remove-device",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -361,7 +422,7 @@
} }
} }
}, },
"/api/v2/admin_notifications/{userId}": { "/ocs/v1.php/apps/notifications/api/v2/admin_notifications/{userId}": {
"parameters": [ "parameters": [
{ {
"name": "userId", "name": "userId",
@ -374,6 +435,9 @@
], ],
"post": { "post": {
"operationId": "send-admin-notification", "operationId": "send-admin-notification",
"tags": [
"notifications"
],
"parameters": [ "parameters": [
{ {
"name": "shortMessage", "name": "shortMessage",

57
specs/provisioning_api.json
Unescape View File

@ -1,16 +1,17 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Provisioning API", "title": "Provisioning API",
"version": "1.14.0", "version": "1.14.0",
"description": "This application enables a set of APIs that external systems can use to manage users, groups and apps.", "description": "This application enables a set of APIs that external systems can use to manage users, groups and apps.",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
{ {
"url": "https://{hostname}:{port}/ocs/v1.php/cloud", "url": "https://{hostname}:{port}",
"variables": { "variables": {
"hostname": { "hostname": {
"default": "localhost" "default": "localhost"
@ -26,17 +27,32 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "provisioning_api"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"OCSMeta": { "OCSMeta": {
"deprecated": true, "type": "object",
"description": "Stub" "properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}, },
"ProvisioningApiUser": { "ProvisioningApiUser": {
"type": "object", "type": "object",
@ -57,6 +73,9 @@
"ProvisioningApiUserDetails": { "ProvisioningApiUserDetails": {
"type": "object", "type": "object",
"properties": { "properties": {
"enabled": {
"type": "boolean"
},
"storageLocation": { "storageLocation": {
"type": "string" "type": "string"
}, },
@ -207,12 +226,21 @@
} }
} }
} }
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
} }
}, },
"paths": { "paths": {
"/user": { "/ocs/v1.php/cloud/user": {
"get": { "get": {
"operationId": "get-current-user", "operationId": "get-current-user",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -227,7 +255,7 @@
} }
} }
}, },
"/users/{userId}": { "/ocs/v1.php/cloud/users/{userId}": {
"parameters": [ "parameters": [
{ {
"name": "userId", "name": "userId",
@ -240,6 +268,9 @@
], ],
"get": { "get": {
"operationId": "get-user", "operationId": "get-user",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",

275
specs/templates/core.json
Unescape View File

@ -1,43 +1,26 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Core", "title": "Core",
"version": "24.0.5", "version": "24.0.5",
"description": "Core functionality of Nextcloud", "description": "Core functionality of Nextcloud",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "tags": [
{ {
"url": "https://{hostname}:{port}", "name": "core"
"variables": {
"hostname": {
"default": "localhost"
},
"port": {
"default": "8080"
}
}
}
],
"security": [
{
"basic_auth": []
} }
], ],
"components": {
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": { "paths": {
"/core/lostpassword/email": { "/core/lostpassword/email": {
"post": { "post": {
"operationId": "lost-email-TODO", "operationId": "lost-email-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "user", "name": "user",
@ -83,6 +66,9 @@
], ],
"get": { "get": {
"operationId": "lost-resetform-TODO", "operationId": "lost-resetform-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -118,6 +104,9 @@
], ],
"post": { "post": {
"operationId": "lost-setpassword-TODO", "operationId": "lost-setpassword-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "password", "name": "password",
@ -132,7 +121,7 @@
"in": "query", "in": "query",
"required": true, "required": true,
"schema": { "schema": {
"type": "boolean" "type": "integer"
} }
} }
], ],
@ -163,6 +152,9 @@
], ],
"get": { "get": {
"operationId": "profilepage-index-TODO", "operationId": "profilepage-index-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -180,6 +172,9 @@
"/core/displaynames": { "/core/displaynames": {
"post": { "post": {
"operationId": "user-getdisplaynames-TODO", "operationId": "user-getdisplaynames-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "users", "name": "users",
@ -225,6 +220,9 @@
], ],
"get": { "get": {
"operationId": "avatar-getavatar-TODO", "operationId": "avatar-getavatar-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -242,6 +240,9 @@
"/core/avatar": { "/core/avatar": {
"post": { "post": {
"operationId": "avatar-postavatar-TODO", "operationId": "avatar-postavatar-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "path", "name": "path",
@ -267,6 +268,9 @@
}, },
"delete": { "delete": {
"operationId": "avatar-deleteavatar-TODO", "operationId": "avatar-deleteavatar-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -284,6 +288,9 @@
"/core/avatar/cropped": { "/core/avatar/cropped": {
"post": { "post": {
"operationId": "avatar-postcroppedavatar-TODO", "operationId": "avatar-postcroppedavatar-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "crop", "name": "crop",
@ -311,6 +318,9 @@
"/core/avatar/tmp": { "/core/avatar/tmp": {
"get": { "get": {
"operationId": "avatar-gettmpavatar-TODO", "operationId": "avatar-gettmpavatar-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -348,6 +358,9 @@
], ],
"get": { "get": {
"operationId": "guestavatar-getavatar-TODO", "operationId": "guestavatar-getavatar-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -365,6 +378,9 @@
"/core/csrftoken": { "/core/csrftoken": {
"get": { "get": {
"operationId": "csrftoken-index-TODO", "operationId": "csrftoken-index-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -382,6 +398,9 @@
"/core/login": { "/core/login": {
"get": { "get": {
"operationId": "login-showloginform-TODO", "operationId": "login-showloginform-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "user", "name": "user",
@ -415,6 +434,9 @@
}, },
"post": { "post": {
"operationId": "login-trylogin-TODO", "operationId": "login-trylogin-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "user", "name": "user",
@ -476,6 +498,9 @@
"/core/login/confirm": { "/core/login/confirm": {
"post": { "post": {
"operationId": "login-confirmpassword-TODO", "operationId": "login-confirmpassword-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "password", "name": "password",
@ -503,6 +528,9 @@
"/core/logout": { "/core/logout": {
"get": { "get": {
"operationId": "login-logout-TODO", "operationId": "login-logout-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -520,6 +548,9 @@
"/core/login/flow": { "/core/login/flow": {
"get": { "get": {
"operationId": "clientflowlogin-showauthpickerpage-TODO", "operationId": "clientflowlogin-showauthpickerpage-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "clientIdentifier", "name": "clientIdentifier",
@ -564,6 +595,9 @@
}, },
"post": { "post": {
"operationId": "clientflowlogin-generateapppassword-TODO", "operationId": "clientflowlogin-generateapppassword-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -600,6 +634,9 @@
"/core/login/flow/grant": { "/core/login/flow/grant": {
"get": { "get": {
"operationId": "clientflowlogin-grantpage-TODO", "operationId": "clientflowlogin-grantpage-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -646,6 +683,9 @@
"/core/login/flow/apptoken": { "/core/login/flow/apptoken": {
"post": { "post": {
"operationId": "clientflowlogin-apptokenredirect-TODO", "operationId": "clientflowlogin-apptokenredirect-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -689,6 +729,9 @@
"/core/login/v2/poll": { "/core/login/v2/poll": {
"post": { "post": {
"operationId": "clientflowloginv2-poll-TODO", "operationId": "clientflowloginv2-poll-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "token", "name": "token",
@ -716,6 +759,9 @@
"/core/login/v2/flow": { "/core/login/v2/flow": {
"get": { "get": {
"operationId": "clientflowloginv2-showauthpickerpage-TODO", "operationId": "clientflowloginv2-showauthpickerpage-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "user", "name": "user",
@ -754,6 +800,9 @@
], ],
"get": { "get": {
"operationId": "clientflowloginv2-landing-TODO", "operationId": "clientflowloginv2-landing-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "user", "name": "user",
@ -782,6 +831,9 @@
"/core/login/v2/grant": { "/core/login/v2/grant": {
"get": { "get": {
"operationId": "clientflowloginv2-grantpage-TODO", "operationId": "clientflowloginv2-grantpage-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -807,6 +859,9 @@
}, },
"post": { "post": {
"operationId": "clientflowloginv2-generateapppassword-TODO", "operationId": "clientflowloginv2-generateapppassword-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -834,6 +889,9 @@
"/core/login/v2": { "/core/login/v2": {
"post": { "post": {
"operationId": "clientflowloginv2-init-TODO", "operationId": "clientflowloginv2-init-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -851,6 +909,9 @@
"/core/login/v2/apptoken": { "/core/login/v2/apptoken": {
"post": { "post": {
"operationId": "clientflowloginv2-apptokenredirect-TODO", "operationId": "clientflowloginv2-apptokenredirect-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "stateToken", "name": "stateToken",
@ -894,6 +955,9 @@
"/core/login/selectchallenge": { "/core/login/selectchallenge": {
"get": { "get": {
"operationId": "twofactorchallenge-selectchallenge-TODO", "operationId": "twofactorchallenge-selectchallenge-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "redirect_url", "name": "redirect_url",
@ -931,6 +995,9 @@
], ],
"get": { "get": {
"operationId": "twofactorchallenge-showchallenge-TODO", "operationId": "twofactorchallenge-showchallenge-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "redirect_url", "name": "redirect_url",
@ -956,6 +1023,9 @@
}, },
"post": { "post": {
"operationId": "twofactorchallenge-solvechallenge-TODO", "operationId": "twofactorchallenge-solvechallenge-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "challenge", "name": "challenge",
@ -991,6 +1061,9 @@
"/core/login/setupchallenge": { "/core/login/setupchallenge": {
"get": { "get": {
"operationId": "twofactorchallenge-setupproviders-TODO", "operationId": "twofactorchallenge-setupproviders-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1018,6 +1091,9 @@
], ],
"get": { "get": {
"operationId": "twofactorchallenge-setupprovider-TODO", "operationId": "twofactorchallenge-setupprovider-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1033,6 +1109,9 @@
}, },
"post": { "post": {
"operationId": "twofactorchallenge-confirmprovidersetup-TODO", "operationId": "twofactorchallenge-confirmprovidersetup-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1050,6 +1129,9 @@
"/core/core/js/oc.js": { "/core/core/js/oc.js": {
"get": { "get": {
"operationId": "ocjs-getconfig-TODO", "operationId": "ocjs-getconfig-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1067,6 +1149,9 @@
"/core/core/preview": { "/core/core/preview": {
"get": { "get": {
"operationId": "preview-getpreviewbyfileid-TODO", "operationId": "preview-getpreviewbyfileid-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "fileId", "name": "fileId",
@ -1100,8 +1185,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
}, },
{ {
@ -1109,8 +1194,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": true "default": 0
} }
}, },
{ {
@ -1140,6 +1225,9 @@
"/core/core/preview.png": { "/core/core/preview.png": {
"get": { "get": {
"operationId": "preview-getpreview-TODO", "operationId": "preview-getpreview-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "file", "name": "file",
@ -1173,8 +1261,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
}, },
{ {
@ -1182,8 +1270,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": true "default": 0
} }
}, },
{ {
@ -1213,6 +1301,9 @@
"/core/core/apps/recommended": { "/core/core/apps/recommended": {
"get": { "get": {
"operationId": "recommendedapps-index-TODO", "operationId": "recommendedapps-index-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1248,6 +1339,9 @@
], ],
"get": { "get": {
"operationId": "svg-getsvgfromcore-TODO", "operationId": "svg-getsvgfromcore-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "color", "name": "color",
@ -1294,6 +1388,9 @@
], ],
"get": { "get": {
"operationId": "svg-getsvgfromapp-TODO", "operationId": "svg-getsvgfromapp-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "color", "name": "color",
@ -1342,6 +1439,9 @@
], ],
"get": { "get": {
"operationId": "css-getcss-TODO", "operationId": "css-getcss-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1379,6 +1479,9 @@
], ],
"get": { "get": {
"operationId": "js-getjs-TODO", "operationId": "js-getjs-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1396,6 +1499,9 @@
"/core/contactsmenu/contacts": { "/core/contactsmenu/contacts": {
"post": { "post": {
"operationId": "contactsmenu-index-TODO", "operationId": "contactsmenu-index-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "filter", "name": "filter",
@ -1423,6 +1529,9 @@
"/core/contactsmenu/findOne": { "/core/contactsmenu/findOne": {
"post": { "post": {
"operationId": "contactsmenu-findone-TODO", "operationId": "contactsmenu-findone-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "shareType", "name": "shareType",
@ -1458,6 +1567,9 @@
"/core/204": { "/core/204": {
"get": { "get": {
"operationId": "walledgarden-get-TODO", "operationId": "walledgarden-get-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1475,6 +1587,9 @@
"/core/core/search": { "/core/core/search": {
"get": { "get": {
"operationId": "search-search-TODO", "operationId": "search-search-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "query", "name": "query",
@ -1528,6 +1643,9 @@
"/core/core/wipe/check": { "/core/core/wipe/check": {
"post": { "post": {
"operationId": "wipe-checkwipe-TODO", "operationId": "wipe-checkwipe-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "token", "name": "token",
@ -1555,6 +1673,9 @@
"/core/core/wipe/success": { "/core/core/wipe/success": {
"post": { "post": {
"operationId": "wipe-wipedone-TODO", "operationId": "wipe-wipedone-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "token", "name": "token",
@ -1582,6 +1703,9 @@
"/core/login/webauthn/start": { "/core/login/webauthn/start": {
"post": { "post": {
"operationId": "webauthn-startauthentication-TODO", "operationId": "webauthn-startauthentication-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "loginName", "name": "loginName",
@ -1609,6 +1733,9 @@
"/core/login/webauthn/finish": { "/core/login/webauthn/finish": {
"post": { "post": {
"operationId": "webauthn-finishauthentication-TODO", "operationId": "webauthn-finishauthentication-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "data", "name": "data",
@ -1646,6 +1773,9 @@
], ],
"get": { "get": {
"operationId": "wellknown-handle-TODO", "operationId": "wellknown-handle-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1663,6 +1793,9 @@
"/ocs/v1.php/core/capabilities": { "/ocs/v1.php/core/capabilities": {
"get": { "get": {
"operationId": "ocs-getcapabilities-TODO", "operationId": "ocs-getcapabilities-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1680,6 +1813,9 @@
"/ocs/v1.php/core/config": { "/ocs/v1.php/core/config": {
"get": { "get": {
"operationId": "ocs-getconfig-TODO", "operationId": "ocs-getconfig-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1697,6 +1833,9 @@
"/ocs/v1.php/core/check": { "/ocs/v1.php/core/check": {
"post": { "post": {
"operationId": "ocs-personcheck-TODO", "operationId": "ocs-personcheck-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "login", "name": "login",
@ -1744,6 +1883,9 @@
], ],
"get": { "get": {
"operationId": "ocs-getidentityproof-TODO", "operationId": "ocs-getidentityproof-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1761,14 +1903,17 @@
"/ocs/v1.php/core/navigation/apps": { "/ocs/v1.php/core/navigation/apps": {
"get": { "get": {
"operationId": "navigation-getappsnavigation-TODO", "operationId": "navigation-getappsnavigation-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "absolute", "name": "absolute",
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
} }
], ],
@ -1789,14 +1934,17 @@
"/ocs/v1.php/core/navigation/settings": { "/ocs/v1.php/core/navigation/settings": {
"get": { "get": {
"operationId": "navigation-getsettingsnavigation-TODO", "operationId": "navigation-getsettingsnavigation-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "absolute", "name": "absolute",
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
} }
], ],
@ -1817,6 +1965,9 @@
"/ocs/v1.php/core/autocomplete/get": { "/ocs/v1.php/core/autocomplete/get": {
"get": { "get": {
"operationId": "autocomplete-get-TODO", "operationId": "autocomplete-get-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -1886,6 +2037,9 @@
"/ocs/v1.php/core/whatsnew": { "/ocs/v1.php/core/whatsnew": {
"get": { "get": {
"operationId": "whatsnew-get-TODO", "operationId": "whatsnew-get-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1901,6 +2055,9 @@
}, },
"post": { "post": {
"operationId": "whatsnew-dismiss-TODO", "operationId": "whatsnew-dismiss-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "version", "name": "version",
@ -1928,6 +2085,9 @@
"/ocs/v1.php/core/getapppassword": { "/ocs/v1.php/core/getapppassword": {
"get": { "get": {
"operationId": "apppassword-getapppassword-TODO", "operationId": "apppassword-getapppassword-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1945,6 +2105,9 @@
"/ocs/v1.php/core/apppassword/rotate": { "/ocs/v1.php/core/apppassword/rotate": {
"post": { "post": {
"operationId": "apppassword-rotateapppassword-TODO", "operationId": "apppassword-rotateapppassword-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1962,6 +2125,9 @@
"/ocs/v1.php/core/apppassword": { "/ocs/v1.php/core/apppassword": {
"delete": { "delete": {
"operationId": "apppassword-deleteapppassword-TODO", "operationId": "apppassword-deleteapppassword-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1989,6 +2155,9 @@
], ],
"get": { "get": {
"operationId": "hovercard-getuser-TODO", "operationId": "hovercard-getuser-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -2016,6 +2185,9 @@
], ],
"get": { "get": {
"operationId": "collaborationresources-searchcollections-TODO", "operationId": "collaborationresources-searchcollections-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -2043,6 +2215,9 @@
], ],
"get": { "get": {
"operationId": "collaborationresources-listcollection-TODO", "operationId": "collaborationresources-listcollection-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -2058,6 +2233,9 @@
}, },
"put": { "put": {
"operationId": "collaborationresources-renamecollection-TODO", "operationId": "collaborationresources-renamecollection-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "collectionName", "name": "collectionName",
@ -2083,6 +2261,9 @@
}, },
"post": { "post": {
"operationId": "collaborationresources-addresource-TODO", "operationId": "collaborationresources-addresource-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "resourceType", "name": "resourceType",
@ -2116,6 +2297,9 @@
}, },
"delete": { "delete": {
"operationId": "collaborationresources-removeresource-TODO", "operationId": "collaborationresources-removeresource-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "resourceType", "name": "resourceType",
@ -2169,6 +2353,9 @@
], ],
"get": { "get": {
"operationId": "collaborationresources-getcollectionsbyresource-TODO", "operationId": "collaborationresources-getcollectionsbyresource-TODO",
"tags": [
"core"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -2204,6 +2391,9 @@
], ],
"post": { "post": {
"operationId": "collaborationresources-createcollectiononresource-TODO", "operationId": "collaborationresources-createcollectiononresource-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "name", "name": "name",
@ -2241,6 +2431,9 @@
], ],
"put": { "put": {
"operationId": "profileapi-setvisibility-TODO", "operationId": "profileapi-setvisibility-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "paramId", "name": "paramId",
@ -2276,6 +2469,9 @@
"/ocs/v1.php/core/providers": { "/ocs/v1.php/core/providers": {
"get": { "get": {
"operationId": "unifiedsearch-getproviders-TODO", "operationId": "unifiedsearch-getproviders-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "from", "name": "from",
@ -2315,6 +2511,9 @@
], ],
"get": { "get": {
"operationId": "unifiedsearch-search-TODO", "operationId": "unifiedsearch-search-TODO",
"tags": [
"core"
],
"parameters": [ "parameters": [
{ {
"name": "term", "name": "term",

397
specs/templates/news.json
View File

File diff suppressed because it is too large Load Diff

127
specs/templates/notes.json
Unescape View File

@ -1,43 +1,26 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Notes", "title": "Notes",
"version": "4.5.1", "version": "4.5.1",
"description": "Distraction-free notes and writing", "description": "Distraction-free notes and writing",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "tags": [
{ {
"url": "https://{hostname}:{port}/apps/notes", "name": "notes"
"variables": {
"hostname": {
"default": "localhost"
},
"port": {
"default": "8080"
}
}
} }
], ],
"security": [
{
"basic_auth": []
}
],
"components": {
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": { "paths": {
"/notes": { "/apps/notes/notes": {
"get": { "get": {
"operationId": "notes-index-TODO", "operationId": "notes-index-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "pruneBefore", "name": "pruneBefore",
@ -64,6 +47,9 @@
}, },
"post": { "post": {
"operationId": "notes-create-TODO", "operationId": "notes-create-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "category", "name": "category",
@ -88,9 +74,12 @@
} }
} }
}, },
"/notes/dashboard": { "/apps/notes/notes/dashboard": {
"get": { "get": {
"operationId": "notes-dashboard-TODO", "operationId": "notes-dashboard-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -105,7 +94,7 @@
} }
} }
}, },
"/notes/{id}": { "/apps/notes/notes/{id}": {
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -118,6 +107,9 @@
], ],
"get": { "get": {
"operationId": "notes-get-TODO", "operationId": "notes-get-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -133,6 +125,9 @@
}, },
"put": { "put": {
"operationId": "notes-update-TODO", "operationId": "notes-update-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "content", "name": "content",
@ -158,6 +153,9 @@
}, },
"delete": { "delete": {
"operationId": "notes-destroy-TODO", "operationId": "notes-destroy-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -172,9 +170,12 @@
} }
} }
}, },
"/notes/undo": { "/apps/notes/notes/undo": {
"post": { "post": {
"operationId": "notes-undo-TODO", "operationId": "notes-undo-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -221,7 +222,7 @@
"in": "query", "in": "query",
"required": true, "required": true,
"schema": { "schema": {
"type": "boolean" "type": "integer"
} }
} }
], ],
@ -239,7 +240,7 @@
} }
} }
}, },
"/notes/{id}/autotitle": { "/apps/notes/notes/{id}/autotitle": {
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -252,6 +253,9 @@
], ],
"put": { "put": {
"operationId": "notes-autotitle-TODO", "operationId": "notes-autotitle-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -266,7 +270,7 @@
} }
} }
}, },
"/notes/{id}/{property}": { "/apps/notes/notes/{id}/{property}": {
"parameters": [ "parameters": [
{ {
"name": "id", "name": "id",
@ -287,6 +291,9 @@
], ],
"put": { "put": {
"operationId": "notes-updateproperty-TODO", "operationId": "notes-updateproperty-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "modified", "name": "modified",
@ -317,7 +324,7 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean" "type": "integer"
} }
} }
], ],
@ -335,7 +342,7 @@
} }
} }
}, },
"/notes/{noteid}/attachment": { "/apps/notes/notes/{noteid}/attachment": {
"parameters": [ "parameters": [
{ {
"name": "noteid", "name": "noteid",
@ -348,6 +355,9 @@
], ],
"get": { "get": {
"operationId": "notes-getattachment-TODO", "operationId": "notes-getattachment-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "path", "name": "path",
@ -373,6 +383,9 @@
}, },
"post": { "post": {
"operationId": "notes-uploadfile-TODO", "operationId": "notes-uploadfile-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -387,9 +400,12 @@
} }
} }
}, },
"/settings": { "/apps/notes/settings": {
"get": { "get": {
"operationId": "settings-get-TODO", "operationId": "settings-get-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -405,6 +421,9 @@
}, },
"put": { "put": {
"operationId": "settings-set-TODO", "operationId": "settings-set-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -419,7 +438,7 @@
} }
} }
}, },
"/api/{apiVersion}/notes": { "/apps/notes/api/{apiVersion}/notes": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -432,6 +451,9 @@
], ],
"get": { "get": {
"operationId": "notes_api-index-TODO", "operationId": "notes_api-index-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "category", "name": "category",
@ -492,6 +514,9 @@
}, },
"post": { "post": {
"operationId": "notes_api-create-TODO", "operationId": "notes_api-create-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "category", "name": "category",
@ -534,8 +559,8 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean", "type": "integer",
"default": false "default": 0
} }
} }
], ],
@ -553,7 +578,7 @@
} }
} }
}, },
"/api/{apiVersion}/notes/{id}": { "/apps/notes/api/{apiVersion}/notes/{id}": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -574,6 +599,9 @@
], ],
"get": { "get": {
"operationId": "notes_api-get-TODO", "operationId": "notes_api-get-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "exclude", "name": "exclude",
@ -600,6 +628,9 @@
}, },
"put": { "put": {
"operationId": "notes_api-update-TODO", "operationId": "notes_api-update-TODO",
"tags": [
"notes"
],
"parameters": [ "parameters": [
{ {
"name": "content", "name": "content",
@ -638,7 +669,7 @@
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "boolean" "type": "integer"
} }
} }
], ],
@ -657,6 +688,9 @@
}, },
"delete": { "delete": {
"operationId": "notes_api-destroy-TODO", "operationId": "notes_api-destroy-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -671,7 +705,7 @@
} }
} }
}, },
"/api/{apiVersion}/settings": { "/apps/notes/api/{apiVersion}/settings": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -684,6 +718,9 @@
], ],
"get": { "get": {
"operationId": "notes_api-getsettings-TODO", "operationId": "notes_api-getsettings-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -699,6 +736,9 @@
}, },
"put": { "put": {
"operationId": "notes_api-setsettings-TODO", "operationId": "notes_api-setsettings-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -713,7 +753,7 @@
} }
} }
}, },
"/api/{catchAll}": { "/apps/notes/api/{catchAll}": {
"parameters": [ "parameters": [
{ {
"name": "catchAll", "name": "catchAll",
@ -726,6 +766,9 @@
], ],
"get": { "get": {
"operationId": "notes_api-fail-TODO", "operationId": "notes_api-fail-TODO",
"tags": [
"notes"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",

64
specs/templates/notifications.json
Unescape View File

@ -1,41 +1,21 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Notifications", "title": "Notifications",
"version": "2.12.1", "version": "2.12.1",
"description": "This app provides a backend and frontend for the notification API available in Nextcloud.", "description": "This app provides a backend and frontend for the notification API available in Nextcloud.",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "tags": [
{ {
"url": "https://{hostname}:{port}/ocs/v1.php/apps/notifications", "name": "notifications"
"variables": {
"hostname": {
"default": "localhost"
},
"port": {
"default": "8080"
}
}
} }
], ],
"security": [
{
"basic_auth": []
}
],
"components": {
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": { "paths": {
"/api/{apiVersion}/notifications": { "/ocs/v1.php/apps/notifications/api/{apiVersion}/notifications": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -48,6 +28,9 @@
], ],
"get": { "get": {
"operationId": "endpoint-listnotifications-TODO", "operationId": "endpoint-listnotifications-TODO",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -63,6 +46,9 @@
}, },
"delete": { "delete": {
"operationId": "endpoint-deleteallnotifications-TODO", "operationId": "endpoint-deleteallnotifications-TODO",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -77,7 +63,7 @@
} }
} }
}, },
"/api/{apiVersion}/notifications/{id}": { "/ocs/v1.php/apps/notifications/api/{apiVersion}/notifications/{id}": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -98,6 +84,9 @@
], ],
"get": { "get": {
"operationId": "endpoint-getnotification-TODO", "operationId": "endpoint-getnotification-TODO",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -113,6 +102,9 @@
}, },
"delete": { "delete": {
"operationId": "endpoint-deletenotification-TODO", "operationId": "endpoint-deletenotification-TODO",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -127,7 +119,7 @@
} }
} }
}, },
"/api/{apiVersion}/push": { "/ocs/v1.php/apps/notifications/api/{apiVersion}/push": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -140,6 +132,9 @@
], ],
"post": { "post": {
"operationId": "push-registerdevice-TODO", "operationId": "push-registerdevice-TODO",
"tags": [
"notifications"
],
"parameters": [ "parameters": [
{ {
"name": "pushTokenHash", "name": "pushTokenHash",
@ -181,6 +176,9 @@
}, },
"delete": { "delete": {
"operationId": "push-removedevice-TODO", "operationId": "push-removedevice-TODO",
"tags": [
"notifications"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -195,7 +193,7 @@
} }
} }
}, },
"/api/{apiVersion}/admin_notifications/{userId}": { "/ocs/v1.php/apps/notifications/api/{apiVersion}/admin_notifications/{userId}": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -216,6 +214,9 @@
], ],
"post": { "post": {
"operationId": "api-generatenotification-TODO", "operationId": "api-generatenotification-TODO",
"tags": [
"notifications"
],
"parameters": [ "parameters": [
{ {
"name": "shortMessage", "name": "shortMessage",
@ -249,7 +250,7 @@
} }
} }
}, },
"/api/{apiVersion}/settings": { "/ocs/v1.php/apps/notifications/api/{apiVersion}/settings": {
"parameters": [ "parameters": [
{ {
"name": "apiVersion", "name": "apiVersion",
@ -262,6 +263,9 @@
], ],
"post": { "post": {
"operationId": "settings-personal-TODO", "operationId": "settings-personal-TODO",
"tags": [
"notifications"
],
"parameters": [ "parameters": [
{ {
"name": "batchSetting", "name": "batchSetting",

153
specs/templates/provisioning_api.json
Unescape View File

@ -1,43 +1,26 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "Provisioning API", "title": "Provisioning API",
"version": "1.14.0", "version": "1.14.0",
"description": "This application enables a set of APIs that external systems can use to manage users, groups and apps.", "description": "This application enables a set of APIs that external systems can use to manage users, groups and apps.",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "tags": [
{ {
"url": "https://{hostname}:{port}", "name": "provisioning_api"
"variables": {
"hostname": {
"default": "localhost"
},
"port": {
"default": "8080"
}
}
} }
], ],
"security": [
{
"basic_auth": []
}
],
"components": {
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": { "paths": {
"/ocs/v1.php/apps/provisioning_api/apps": { "/ocs/v1.php/apps/provisioning_api/apps": {
"get": { "get": {
"operationId": "apps-getapps-TODO", "operationId": "apps-getapps-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "filter", "name": "filter",
@ -75,6 +58,9 @@
], ],
"get": { "get": {
"operationId": "apps-getappinfo-TODO", "operationId": "apps-getappinfo-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -90,6 +76,9 @@
}, },
"post": { "post": {
"operationId": "apps-enable-TODO", "operationId": "apps-enable-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -105,6 +94,9 @@
}, },
"delete": { "delete": {
"operationId": "apps-disable-TODO", "operationId": "apps-disable-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -122,6 +114,9 @@
"/ocs/v1.php/apps/provisioning_api/groups": { "/ocs/v1.php/apps/provisioning_api/groups": {
"get": { "get": {
"operationId": "groups-getgroups-TODO", "operationId": "groups-getgroups-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -165,6 +160,9 @@
}, },
"post": { "post": {
"operationId": "groups-addgroup-TODO", "operationId": "groups-addgroup-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "groupid", "name": "groupid",
@ -201,6 +199,9 @@
"/ocs/v1.php/apps/provisioning_api/groups/details": { "/ocs/v1.php/apps/provisioning_api/groups/details": {
"get": { "get": {
"operationId": "groups-getgroupsdetails-TODO", "operationId": "groups-getgroupsdetails-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -256,6 +257,9 @@
], ],
"get": { "get": {
"operationId": "groups-getgroupusers-TODO", "operationId": "groups-getgroupusers-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -283,6 +287,9 @@
], ],
"get": { "get": {
"operationId": "groups-getgroupusersdetails-TODO", "operationId": "groups-getgroupusersdetails-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -338,6 +345,9 @@
], ],
"get": { "get": {
"operationId": "groups-getsubadminsofgroup-TODO", "operationId": "groups-getsubadminsofgroup-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -365,6 +375,9 @@
], ],
"get": { "get": {
"operationId": "groups-getgroup-TODO", "operationId": "groups-getgroup-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -380,6 +393,9 @@
}, },
"put": { "put": {
"operationId": "groups-updategroup-TODO", "operationId": "groups-updategroup-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "key", "name": "key",
@ -413,6 +429,9 @@
}, },
"delete": { "delete": {
"operationId": "groups-deletegroup-TODO", "operationId": "groups-deletegroup-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -430,6 +449,9 @@
"/ocs/v1.php/apps/provisioning_api/users": { "/ocs/v1.php/apps/provisioning_api/users": {
"get": { "get": {
"operationId": "users-getusers-TODO", "operationId": "users-getusers-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -473,6 +495,9 @@
}, },
"post": { "post": {
"operationId": "users-adduser-TODO", "operationId": "users-adduser-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "userid", "name": "userid",
@ -561,6 +586,9 @@
"/ocs/v1.php/apps/provisioning_api/users/details": { "/ocs/v1.php/apps/provisioning_api/users/details": {
"get": { "get": {
"operationId": "users-getusersdetails-TODO", "operationId": "users-getusersdetails-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "search", "name": "search",
@ -606,6 +634,9 @@
"/ocs/v1.php/apps/provisioning_api/users/search/by-phone": { "/ocs/v1.php/apps/provisioning_api/users/search/by-phone": {
"post": { "post": {
"operationId": "users-searchbyphonenumbers-TODO", "operationId": "users-searchbyphonenumbers-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "location", "name": "location",
@ -651,6 +682,9 @@
], ],
"get": { "get": {
"operationId": "users-getuser-TODO", "operationId": "users-getuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -666,6 +700,9 @@
}, },
"put": { "put": {
"operationId": "users-edituser-TODO", "operationId": "users-edituser-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "key", "name": "key",
@ -699,6 +736,9 @@
}, },
"delete": { "delete": {
"operationId": "users-deleteuser-TODO", "operationId": "users-deleteuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -716,6 +756,9 @@
"/ocs/v1.php/apps/provisioning_api/user": { "/ocs/v1.php/apps/provisioning_api/user": {
"get": { "get": {
"operationId": "users-getcurrentuser-TODO", "operationId": "users-getcurrentuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -733,6 +776,9 @@
"/ocs/v1.php/apps/provisioning_api/user/fields": { "/ocs/v1.php/apps/provisioning_api/user/fields": {
"get": { "get": {
"operationId": "users-geteditablefields-TODO", "operationId": "users-geteditablefields-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -760,6 +806,9 @@
], ],
"get": { "get": {
"operationId": "users-geteditablefieldsforuser-TODO", "operationId": "users-geteditablefieldsforuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -795,6 +844,9 @@
], ],
"put": { "put": {
"operationId": "users-editusermultivalue-TODO", "operationId": "users-editusermultivalue-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "key", "name": "key",
@ -840,6 +892,9 @@
], ],
"post": { "post": {
"operationId": "users-wipeuserdevices-TODO", "operationId": "users-wipeuserdevices-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -867,6 +922,9 @@
], ],
"put": { "put": {
"operationId": "users-enableuser-TODO", "operationId": "users-enableuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -894,6 +952,9 @@
], ],
"put": { "put": {
"operationId": "users-disableuser-TODO", "operationId": "users-disableuser-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -921,6 +982,9 @@
], ],
"get": { "get": {
"operationId": "users-getusersgroups-TODO", "operationId": "users-getusersgroups-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -936,6 +1000,9 @@
}, },
"post": { "post": {
"operationId": "users-addtogroup-TODO", "operationId": "users-addtogroup-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "groupid", "name": "groupid",
@ -962,6 +1029,9 @@
}, },
"delete": { "delete": {
"operationId": "users-removefromgroup-TODO", "operationId": "users-removefromgroup-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "groupid", "name": "groupid",
@ -999,6 +1069,9 @@
], ],
"get": { "get": {
"operationId": "users-getusersubadmingroups-TODO", "operationId": "users-getusersubadmingroups-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1014,6 +1087,9 @@
}, },
"post": { "post": {
"operationId": "users-addsubadmin-TODO", "operationId": "users-addsubadmin-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "groupid", "name": "groupid",
@ -1039,6 +1115,9 @@
}, },
"delete": { "delete": {
"operationId": "users-removesubadmin-TODO", "operationId": "users-removesubadmin-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "groupid", "name": "groupid",
@ -1076,6 +1155,9 @@
], ],
"post": { "post": {
"operationId": "users-resendwelcomemessage-TODO", "operationId": "users-resendwelcomemessage-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1093,6 +1175,9 @@
"/ocs/v1.php/apps/provisioning_api/api/v1/config/apps": { "/ocs/v1.php/apps/provisioning_api/api/v1/config/apps": {
"get": { "get": {
"operationId": "appconfig-getapps-TODO", "operationId": "appconfig-getapps-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1120,6 +1205,9 @@
], ],
"get": { "get": {
"operationId": "appconfig-getkeys-TODO", "operationId": "appconfig-getkeys-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1155,6 +1243,9 @@
], ],
"get": { "get": {
"operationId": "appconfig-getvalue-TODO", "operationId": "appconfig-getvalue-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "defaultValue", "name": "defaultValue",
@ -1181,6 +1272,9 @@
}, },
"post": { "post": {
"operationId": "appconfig-setvalue-TODO", "operationId": "appconfig-setvalue-TODO",
"tags": [
"provisioning_api"
],
"parameters": [ "parameters": [
{ {
"name": "value", "name": "value",
@ -1206,6 +1300,9 @@
}, },
"delete": { "delete": {
"operationId": "appconfig-deletekey-TODO", "operationId": "appconfig-deletekey-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1249,6 +1346,9 @@
], ],
"get": { "get": {
"operationId": "verification-showverifymail-TODO", "operationId": "verification-showverifymail-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -1264,6 +1364,9 @@
}, },
"post": { "post": {
"operationId": "verification-verifymail-TODO", "operationId": "verification-verifymail-TODO",
"tags": [
"provisioning_api"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",

57
specs/templates/user_status.json
Unescape View File

@ -1,43 +1,26 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "User status", "title": "User status",
"version": "1.4.0", "version": "1.4.0",
"description": "User status", "description": "User status",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "tags": [
{ {
"url": "https://{hostname}:{port}", "name": "user_status"
"variables": {
"hostname": {
"default": "localhost"
},
"port": {
"default": "8080"
}
}
} }
], ],
"security": [
{
"basic_auth": []
}
],
"components": {
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": { "paths": {
"/ocs/v1.php/apps/user_status/api/v1/statuses": { "/ocs/v1.php/apps/user_status/api/v1/statuses": {
"get": { "get": {
"operationId": "statuses-findall-TODO", "operationId": "statuses-findall-TODO",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "limit", "name": "limit",
@ -83,6 +66,9 @@
], ],
"get": { "get": {
"operationId": "statuses-find-TODO", "operationId": "statuses-find-TODO",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -100,6 +86,9 @@
"/ocs/v1.php/apps/user_status/api/v1/user_status": { "/ocs/v1.php/apps/user_status/api/v1/user_status": {
"get": { "get": {
"operationId": "userstatus-getstatus-TODO", "operationId": "userstatus-getstatus-TODO",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -117,6 +106,9 @@
"/ocs/v1.php/apps/user_status/api/v1/user_status/status": { "/ocs/v1.php/apps/user_status/api/v1/user_status/status": {
"put": { "put": {
"operationId": "userstatus-setstatus-TODO", "operationId": "userstatus-setstatus-TODO",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "statusType", "name": "statusType",
@ -144,6 +136,9 @@
"/ocs/v1.php/apps/user_status/api/v1/user_status/message/predefined": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message/predefined": {
"put": { "put": {
"operationId": "userstatus-setpredefinedmessage-TODO", "operationId": "userstatus-setpredefinedmessage-TODO",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "messageId", "name": "messageId",
@ -179,6 +174,9 @@
"/ocs/v1.php/apps/user_status/api/v1/user_status/message/custom": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message/custom": {
"put": { "put": {
"operationId": "userstatus-setcustommessage-TODO", "operationId": "userstatus-setcustommessage-TODO",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "statusIcon", "name": "statusIcon",
@ -222,6 +220,9 @@
"/ocs/v1.php/apps/user_status/api/v1/user_status/message": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message": {
"delete": { "delete": {
"operationId": "userstatus-clearmessage-TODO", "operationId": "userstatus-clearmessage-TODO",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -239,6 +240,9 @@
"/ocs/v1.php/apps/user_status/api/v1/predefined_statuses": { "/ocs/v1.php/apps/user_status/api/v1/predefined_statuses": {
"get": { "get": {
"operationId": "predefinedstatus-findall-TODO", "operationId": "predefinedstatus-findall-TODO",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -256,6 +260,9 @@
"/apps/user_status/heartbeat": { "/apps/user_status/heartbeat": {
"put": { "put": {
"operationId": "heartbeat-heartbeat-TODO", "operationId": "heartbeat-heartbeat-TODO",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "status", "name": "status",

144
specs/user_status.json
Unescape View File

@ -1,16 +1,17 @@
{ {
"openapi": "3.0.3", "openapi": "3.1.0",
"info": { "info": {
"title": "User status", "title": "User status",
"version": "1.4.0", "version": "1.4.0",
"description": "User status", "description": "User status",
"license": { "license": {
"name": "agpl" "name": "agpl",
"identifier": " AGPL-3.0"
} }
}, },
"servers": [ "servers": [
{ {
"url": "https://{hostname}:{port}/ocs/v1.php/apps/user_status", "url": "https://{hostname}:{port}",
"variables": { "variables": {
"hostname": { "hostname": {
"default": "localhost" "default": "localhost"
@ -26,17 +27,32 @@
"basic_auth": [] "basic_auth": []
} }
], ],
"components": { "tags": [
"securitySchemes": { {
"basic_auth": { "name": "user_status"
"type": "http",
"scheme": "basic"
} }
}, ],
"components": {
"schemas": { "schemas": {
"OCSMeta": { "OCSMeta": {
"deprecated": true, "type": "object",
"description": "Stub" "properties": {
"status": {
"type": "string"
},
"statuscode": {
"type": "integer"
},
"message": {
"type": "string"
},
"totalitems": {
"type": "string"
},
"itemsperpage": {
"type": "string"
}
}
}, },
"UserStatusPredefinedStatuses": { "UserStatusPredefinedStatuses": {
"type": "object", "type": "object",
@ -70,22 +86,49 @@
"type": "string" "type": "string"
}, },
"clearAt": { "clearAt": {
"type": "object" "$ref": "#/components/schemas/UserStatusClearAtWrap"
} }
} }
}, },
"UserStatusClearAtWrap": {
"oneOf": [
{
"$ref": "#/components/schemas/UserStatusClearAt"
},
{
"type": "integer",
"description": "Time as unix timestamp"
}
]
},
"UserStatusClearAt": { "UserStatusClearAt": {
"type": "object", "type": "object",
"properties": { "properties": {
"type": { "type": {
"type": "string" "type": "string",
"enum": [
"period",
"end-of"
]
}, },
"time": { "time": {
"type": "integer" "oneOf": [
{
"type": "string",
"enum": [
"day",
"week"
]
},
{
"type": "integer",
"description": "Time offset in seconds"
}
]
} }
} }
}, },
"UserStatusTypeEnum": { "UserStatusType": {
"type": "string", "type": "string",
"enum": [ "enum": [
"online", "online",
@ -105,7 +148,15 @@
"$ref": "#/components/schemas/OCSMeta" "$ref": "#/components/schemas/OCSMeta"
}, },
"data": { "data": {
"oneOf": [
{
"$ref": "#/components/schemas/UserStatus" "$ref": "#/components/schemas/UserStatus"
},
{
"type": "array",
"description": "Only happens when the user has never set a status"
}
]
} }
} }
} }
@ -165,10 +216,10 @@
"type": "string" "type": "string"
}, },
"clearAt": { "clearAt": {
"type": "object" "$ref": "#/components/schemas/UserStatusClearAtWrap"
}, },
"status": { "status": {
"$ref": "#/components/schemas/UserStatusTypeEnum" "$ref": "#/components/schemas/UserStatusType"
}, },
"statusIsUserDefined": { "statusIsUserDefined": {
"type": "boolean" "type": "boolean"
@ -188,19 +239,28 @@
"type": "string" "type": "string"
}, },
"clearAt": { "clearAt": {
"type": "object" "$ref": "#/components/schemas/UserStatusClearAtWrap"
}, },
"status": { "status": {
"$ref": "#/components/schemas/UserStatusTypeEnum" "$ref": "#/components/schemas/UserStatusType"
}
} }
} }
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
} }
} }
}, },
"paths": { "paths": {
"/api/v1/statuses": { "/ocs/v1.php/apps/user_status/api/v1/statuses": {
"get": { "get": {
"operationId": "find-all-statuses", "operationId": "find-all-statuses",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -215,7 +275,7 @@
} }
} }
}, },
"/api/v1/statuses/{userId}": { "/ocs/v1.php/apps/user_status/api/v1/statuses/{userId}": {
"parameters": [ "parameters": [
{ {
"name": "userId", "name": "userId",
@ -228,6 +288,9 @@
], ],
"get": { "get": {
"operationId": "find-status", "operationId": "find-status",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -242,9 +305,12 @@
} }
} }
}, },
"/api/v1/user_status": { "/ocs/v1.php/apps/user_status/api/v1/user_status": {
"get": { "get": {
"operationId": "get-status", "operationId": "get-status",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -259,16 +325,19 @@
} }
} }
}, },
"/api/v1/user_status/status": { "/ocs/v1.php/apps/user_status/api/v1/user_status/status": {
"put": { "put": {
"operationId": "set-status", "operationId": "set-status",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "statusType", "name": "statusType",
"in": "query", "in": "query",
"required": true, "required": true,
"schema": { "schema": {
"$ref": "#/components/schemas/UserStatusTypeEnum" "$ref": "#/components/schemas/UserStatusType"
} }
} }
], ],
@ -286,9 +355,12 @@
} }
} }
}, },
"/api/v1/user_status/message/predefined": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message/predefined": {
"put": { "put": {
"operationId": "set-predefined-message", "operationId": "set-predefined-message",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "messageId", "name": "messageId",
@ -321,9 +393,12 @@
} }
} }
}, },
"/api/v1/user_status/message/custom": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message/custom": {
"put": { "put": {
"operationId": "set-custom-message", "operationId": "set-custom-message",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "statusIcon", "name": "statusIcon",
@ -364,9 +439,12 @@
} }
} }
}, },
"/api/v1/user_status/message": { "/ocs/v1.php/apps/user_status/api/v1/user_status/message": {
"delete": { "delete": {
"operationId": "clear-message", "operationId": "clear-message",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "" "description": ""
@ -374,9 +452,12 @@
} }
} }
}, },
"/api/v1/predefined_statuses": { "/ocs/v1.php/apps/user_status/api/v1/predefined_statuses": {
"get": { "get": {
"operationId": "find-all-predefined-statuses", "operationId": "find-all-predefined-statuses",
"tags": [
"user_status"
],
"responses": { "responses": {
"200": { "200": {
"description": "", "description": "",
@ -391,17 +472,20 @@
} }
} }
}, },
"/api/v1/heartbeat": { "/ocs/v1.php/apps/user_status/api/v1/heartbeat": {
"description": "Depends on https://github.com/nextcloud/server/pull/32646", "description": "Depends on https://github.com/nextcloud/server/pull/32646",
"put": { "put": {
"operationId": "heartbeat", "operationId": "heartbeat",
"tags": [
"user_status"
],
"parameters": [ "parameters": [
{ {
"name": "status", "name": "status",
"in": "query", "in": "query",
"required": true, "required": true,
"schema": { "schema": {
"$ref": "#/components/schemas/UserStatusTypeEnum" "$ref": "#/components/schemas/UserStatusType"
} }
} }
], ],

Write Preview
Loading…
Cancel
Save