summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoranoy <anoymouserver@users.noreply.github.com>2020-11-11 22:32:11 +0100
committeranoy <anoymouserver@users.noreply.github.com>2020-11-12 10:03:37 +0100
commit05598a7f36a7d4bfc7afb473cc7969ca5d14b55c (patch)
treefa0b2068c32a1cbcb603e54e88ffa8776bd41658
parenta9bd4130085bb603d0793e4578dc1bd919f9d1b1 (diff)
update to match folderId `null` for the root folder
Signed-off-by: anoy <anoymouserver+github@mailbox.org>
-rw-r--r--docs/externalapi/Legacy.md62
1 files changed, 31 insertions, 31 deletions
diff --git a/docs/externalapi/Legacy.md b/docs/externalapi/Legacy.md
index 839502d99..8afb6f9c7 100644
--- a/docs/externalapi/Legacy.md
+++ b/docs/externalapi/Legacy.md
@@ -132,7 +132,7 @@ angular.module('YourApp', [])
In general the input parameters can be in the URL or request body, the App Framework doesnt differentiate between them.
So JSON in the request body like:
-```json
+```jsonc
{
"id": 3
}
@@ -159,7 +159,7 @@ The output is JSON.
* **Route**: /folders
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"folders": [
{
@@ -177,7 +177,7 @@ Creates a new folder and returns a new folder object
* **Method**: POST
* **Route**: /folders
* **Parameters**:
-```json
+```jsonc
{
"name": "folder name"
}
@@ -186,7 +186,7 @@ Creates a new folder and returns a new folder object
* **HTTP 409**: If the folder exists already
* **HTTP 422**: If the folder name is invalid (for instance empty)
* **Returns**:
-```json
+```jsonc
{
"folders": [
{
@@ -215,7 +215,7 @@ Only the name can be updated
* **Method**: PUT
* **Route**: /folders/{folderId}
* **Parameters**:
-```json
+```jsonc
{
"name": "folder name"
}
@@ -232,7 +232,7 @@ Only the name can be updated
* **Method**: PUT
* **Route**: /folders/{folderId}/read
* **Parameters**:
-```json
+```jsonc
{
// mark all items read lower than equal that id
// this is mean to prevent marking items as read which the client/user does not yet know of
@@ -259,7 +259,7 @@ The following attributes are **not sanitized** meaning: including them in your w
* **Route**: /feeds
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"feeds": [
{
@@ -294,17 +294,17 @@ Creates a new feed and returns the feed
* **Method**: POST
* **Route**: /feeds
* **Parameters**:
-```json
+```jsonc
{
"url": "http:\/\/www.cyanogenmod.org\/wp-content\/themes\/cyanogenmod\/images\/favicon.ico",
- "folderId": 81 // id of the parent folder, 0 for root
+ "folderId": 81 // id of the parent folder, null for root
}
```
* **Return codes**:
* **HTTP 409**: If the feed exists already
* **HTTP 422**: If the feed cant be read (most likely contains errors)
* **Returns**:
-```json
+```jsonc
{
"feeds": [
{
@@ -341,9 +341,9 @@ Deletes a feed with the id feedId and all of its items
* **Method**: PUT
* **Route**: /feeds/{feedId}/move
* **Parameters**:
-```json
+```jsonc
{
- "folderId": 0 // id of the parent folder, 0 for root
+ "folderId": null // id of the parent folder, null for root
}
```
* **Return codes**:
@@ -356,9 +356,9 @@ Deletes a feed with the id feedId and all of its items
* **Method**: PUT
* **Route**: /feeds/{feedId}/rename
* **Parameters**:
-```json
+```jsonc
{
- "feedTitle": 'New Title'
+ "feedTitle": "New Title"
}
```
* **Return codes**:
@@ -371,7 +371,7 @@ Deletes a feed with the id feedId and all of its items
* **Method**: PUT
* **Route**: /feeds/{feedId}/read
* **Parameters**:
-```json
+```jsonc
{
// mark all items read lower than equal that id
// this is mean to prevent marking items as read which the client/user does not yet know of
@@ -402,7 +402,7 @@ The following attributes are **not sanitized** meaning: including them in your w
* **Method**: GET
* **Route**: /items
* **Parameters**:
-```json
+```jsonc
{
"batchSize": 10, // the number of items that should be returned, defaults to -1, new in 5.2.3: -1 returns all items
"offset": 30, // only return older (lower than equal that id) items than the one with id 30
@@ -413,7 +413,7 @@ The following attributes are **not sanitized** meaning: including them in your w
}
```
* **Returns**:
-```json
+```jsonc
{
"items": [
{
@@ -446,7 +446,7 @@ Autopaging would work like this:
* Get the **first 20** items from a feed with **id 12**
**GET /items**:
-```json
+```jsonc
{
"batchSize": 20,
"offset": 0,
@@ -460,7 +460,7 @@ The item with the lowest item id is 43.
* Get the next **20** items: **GET /items**:
-```json
+```jsonc
{
"batchSize": 20,
"offset": 43,
@@ -478,7 +478,7 @@ This is used to stay up to date.
* **Method**: GET
* **Route**: /items/updated
* **Parameters**:
-```json
+```jsonc
{
"lastModified": 123231, // returns only items with a lastModified timestamp >= than this one
// this may also return already existing items whose read or starred status
@@ -488,7 +488,7 @@ This is used to stay up to date.
}
```
* **Returns**:
-```json
+```jsonc
{
"items": [
{
@@ -526,7 +526,7 @@ This is used to stay up to date.
* **Method**: PUT
* **Route**: /items/read/multiple
* **Parameters**:
-```json
+```jsonc
{
"items": [2, 3] // ids of the items
}
@@ -547,7 +547,7 @@ This is used to stay up to date.
* **Method**: PUT
* **Route**: /items/unread/multiple
* **Parameters**:
-```json
+```jsonc
{
"items": [2, 3] // ids of the items
}
@@ -568,7 +568,7 @@ This is used to stay up to date.
* **Method**: PUT
* **Route**: /items/star/multiple
* **Parameters**:
-```json
+```jsonc
{
"items": [
{
@@ -594,7 +594,7 @@ This is used to stay up to date.
* **Method**: PUT
* **Route**: /items/unstar/multiple
* **Parameters**:
-```json
+```jsonc
{
"items": [
{
@@ -612,7 +612,7 @@ This is used to stay up to date.
* **Method**: PUT
* **Route**: /items/read
* **Parameters**:
-```json
+```jsonc
{
// mark all items read lower than equal that id
// this is mean to prevent marking items as read which the client/user does not yet know of
@@ -657,7 +657,7 @@ This is used to clean up the database. It deletes folders and feeds that are mar
* **Route**: /feeds/all
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"feeds": [
{
@@ -680,7 +680,7 @@ This is used to clean up the database. It deletes folders and feeds that are mar
* **Method**: GET
* **Route**: /feeds/update
* **Parameters**:
-```json
+```jsonc
{
"userId": "john",
"feedId": 3
@@ -716,7 +716,7 @@ This is used to clean up the database. It removes old read articles which are no
* **Route**: /version
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"version": "5.2.3"
}
@@ -733,7 +733,7 @@ This API can be used to display warnings and errors in your client if the web ap
* **Route**: /status
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"version": "5.2.4",
"warnings": {
@@ -769,7 +769,7 @@ DEPRECATED: This API is deprecated, use the Nextcloud APIs instead.
* **Route**: /user
* **Parameters**: none
* **Returns**:
-```json
+```jsonc
{
"userId": "john",
"displayName": "John Doe",