Implementing OwnCloud API v1: API level #47

New issue

Closed

opened 2017-03-09 22:01:52 -05:00 by jking · 0 comments

jking commented

2017-03-09 22:01:52 -05:00

Owner

This is only documented in the v2 API draft, but is also exposed by the current v1 implementation.

API Level

To find out which API levels are supported, make a request to the following route:

Method: GET
Route: https://yourowncloud.com/index.php/apps/news/api
Authentication: none

The following response is being returned:

Status codes:

200: The supported API levels can be parsed from the response
404: The user is either running a version prior to 8.8.0 or the News app is disabled or not installed.

In case of an HTTP 200, the supported API levels are returned as JSON, e.g.:

{
    "apiLevels": ["v1-2", "v2"]
}

apiLevels: An array of arbitrary long strings, strings represent the the supported api levels which directly correspond to the first fragment after the /api/ Url fragment.

This is only documented in the v2 API draft, but is also exposed by the current v1 implementation. ## API Level To find out which API levels are supported, make a request to the following route: * **Method**: GET * **Route**: https://yourowncloud.com/index.php/apps/news/api * **Authentication**: none The following response is being returned: Status codes: * **200**: The supported API levels can be parsed from the response * **404**: The user is either running a version prior to **8.8.0** or the News app is disabled or not installed. In case of an HTTP 200, the supported API levels are returned as JSON, e.g.: ```json { "apiLevels": ["v1-2", "v2"] } ``` **apiLevels**: An array of arbitrary long strings, strings represent the the supported api levels which directly correspond to the first fragment after the **/api/** Url fragment.