Difference between revisions of "RESTful Guide"
m |
|||
| Line 67: | Line 67: | ||
</source> | </source> | ||
| + | == Folder == | ||
Let's create a new folder: | Let's create a new folder: | ||
| Line 73: | Line 74: | ||
http://localhost:8080/OpenKM/services/rest/folder/createSimple | http://localhost:8080/OpenKM/services/rest/folder/createSimple | ||
| + | == Document == | ||
Now we are going to create a document. For this, we need to provide the document binary data: | Now we are going to create a document. For this, we need to provide the document binary data: | ||
| Line 94: | Line 96: | ||
</source> | </source> | ||
| + | == Security == | ||
| + | Let's see the security info associated to a given node. First show granted users: | ||
| + | |||
| + | $ curl -u okmAdmin:admin -H "Accept: application/json" -X PUT \ | ||
| + | http://localhost:8080/OpenKM/services/rest/auth/getGrantedUsers/3492d662-b58e-417c-85b6-930ad0c6c3cf | ||
| + | |||
| + | And now the granted roles: | ||
| + | |||
| + | $ curl -u okmAdmin:admin -H "Accept: application/json" -X PUT \ | ||
| + | http://localhost:8080/OpenKM/services/rest/auth/getGrantedRoles/3492d662-b58e-417c-85b6-930ad0c6c3cf | ||
| + | |||
| + | == Property Groups == | ||
In this example we add a property group: | In this example we add a property group: | ||
| Line 106: | Line 120: | ||
http://localhost:8080/OpenKM/services/rest/propertyGroup/setPropertiesSimple/3492d662-b58e-417c-85b6-930ad0c6c3cf/okg:technology | http://localhost:8080/OpenKM/services/rest/propertyGroup/setPropertiesSimple/3492d662-b58e-417c-85b6-930ad0c6c3cf/okg:technology | ||
| + | == Notes == | ||
To create a note in a OpenKM folder or document you can do this (previously you need to know the node UUID): | To create a note in a OpenKM folder or document you can do this (previously you need to know the node UUID): | ||
Revision as of 08:55, 4 August 2013
OpenKM has a complete API exposed via REST. This means you can call any of these API methods from any programming language, like Java, PHP or Python among others. This feature makes it possible to create a custom client, or integrate with third-party applications like a CRM or a CMS.
 |
For now this API is only available on OpenKM Professiona 6.4.2. This API is in development, so expect changes. |
If you point your browser to http://localhost:8080/OpenKM/services, you can see the SOAP API at first place but at the bottom you will see a Available RESTful services section. These URLs are protected by BASIC authentication so you need to provide an user and password to access them.
Sample usage
To try these API methods you can use an HTTP Client library or any REST client which ease this process. Or simply you can use the curl command-line application. For example, you can list the children folders:
$ curl -u okmAdmin:admin -H "Accept: application/json" \ http://localhost:8080/OpenKM/services/rest/folder/getChildren/3492d662-b58e-417c-85b6-930ad0c6c3cf
The result is:
{"folderList":
{"folder":
[
{ "author":"okmAdmin",
"created":"2013-07-29T12:09:11+02:00",
"path":"\/okm:root\/alfa",
"permissions":15,
"subscribed":false,
"uuid":"6b3e0531-96a9-4675-bb82-215b715b20ca",
"hasChildren":false },
{ "author":"okmAdmin",
"created":"2013-07-24T22:56:20+02:00",
"path":"\/okm:root\/beta",
"permissions":15,
"subscribed":false,
"uuid":"41f1bace-58b4-41a9-b43e-dffc1ac9a954",
"hasChildren":false}
]
}
}
In this case you can see the result in JSON format. Otherwise you can need an XML output, which can be forced using the 'Accept header:
$ curl -u okmAdmin:admin -H "Accept: application/xml" \ http://localhost:8080/OpenKM/services/rest/folder/getChildren/3492d662-b58e-417c-85b6-930ad0c6c3cf
The result in XML is:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<folderList>
<folder>
<author>okmAdmin</author>
<created>2013-07-29T12:09:11+02:00</created>
<path>/okm:root/alfa</path>
<permissions>15</permissions>
<subscribed>false</subscribed>
<uuid>6b3e0531-96a9-4675-bb82-215b715b20ca</uuid>
<hasChildren>false</hasChildren>
</folder>
<folder>
<author>okmAdmin</author>
<created>2013-07-24T22:56:20+02:00</created>
<path>/okm:root/beta</path>
<permissions>15</permissions>
<subscribed>false</subscribed>
<uuid>41f1bace-58b4-41a9-b43e-dffc1ac9a954</uuid>
<hasChildren>false</hasChildren>
</folder>
</folderList>
Folder
Let's create a new folder:
$ curl -u okmAdmin:admin -H "Accept: application/json" \ -X POST -H "Content-Type: application/json" -d '/okm:root/newfolder' \ http://localhost:8080/OpenKM/services/rest/folder/createSimple
Document
Now we are going to create a document. For this, we need to provide the document binary data:
$ curl -u okmAdmin:admin -H "Accept: application/json" \ -X POST -F docPath=/okm:root/newDoc.txt -F content=@newDoc.txt \ http://localhost:8080/OpenKM/services/rest/document/createSimple
Or also from a HTML form:
<html>
<body>
<form method="POST" enctype="multipart/form-data"
action="http://localhost:8080/OpenKM/services/rest/document/createSimple">
Select file: <input type="file" name="content" size="45"/><br/>
Select path: <input type="text" name="docPath" value="/okm:root/newDoc.txt"/><br/>
<input type="submit" value="Upload" />
</form>
</body>
</html>
Security
Let's see the security info associated to a given node. First show granted users:
$ curl -u okmAdmin:admin -H "Accept: application/json" -X PUT \ http://localhost:8080/OpenKM/services/rest/auth/getGrantedUsers/3492d662-b58e-417c-85b6-930ad0c6c3cf
And now the granted roles:
$ curl -u okmAdmin:admin -H "Accept: application/json" -X PUT \ http://localhost:8080/OpenKM/services/rest/auth/getGrantedRoles/3492d662-b58e-417c-85b6-930ad0c6c3cf
Property Groups
In this example we add a property group:
$ curl -u okmAdmin:admin -H "Accept: application/json" -X PUT \ http://localhost:8080/OpenKM/services/rest/propertyGroup/addGroup/3492d662-b58e-417c-85b6-930ad0c6c3cf/okg:technology
And set some property group values:
$ curl -u okmAdmin:admin -H "Accept: application/json" \ -X PUT -H "Content-Type: application/xml" \ -d '<simplePropertyGroupList><simplePropertyGroup><name>okp:technology.comment</name><value>RESTful rulez!</value></simplePropertyGroup></simplePropertyGroupList>' \ http://localhost:8080/OpenKM/services/rest/propertyGroup/setPropertiesSimple/3492d662-b58e-417c-85b6-930ad0c6c3cf/okg:technology
Notes
To create a note in a OpenKM folder or document you can do this (previously you need to know the node UUID):
$ curl -u okmAdmin:admin -H "Accept: application/json" -X POST -H "Content-Type: application/json" -d 'Hello, world!' \ http://localhost:8080/OpenKM/services/rest/note/add/3492d662-b58e-417c-85b6-930ad0c6c3cf
More info at:
