External API
Introduction
The external API inside ownCloud allows third party developers to access data provided by ownCloud apps. ownCloud follows the OCS v1.7 specification (draft).
Usage
Registering Methods
Methods are registered inside the appinfo/routes.php using :phpOCP\\API
<?php
\OCP\API::register(
'get',
'/apps/yourapp/url',
function($urlParameters) {
return new \OC_OCS_Result($data);
},
'yourapp',
\OC_API::ADMIN_AUTH
);Returning Data
Once the API backend has matched your URL, your callable function as defined in $action will be executed. This method is passed as array of parameters that you defined in $url. To return data back the the client, you should return an instance of :phpOC_OCS_Result. The API backend will then use this to construct the XML or JSON response.
Authentication & Basics
Because REST is stateless you have to send user and password each time you access the API. Therefore running ownCloud with SSL is highly recommended otherwise everyone in your network can log your credentials:
https://user:password@yourowncloud.com/ocs/v1.php/apps/yourapp