Difference between revisions of "Direct link"
From OpenKM Documentation
Line 1: | Line 1: | ||
− | Direct link need a '''user''' which have login grants. A good practice is configure the profile of this user to disallow anything | + | You can download a document from OpenKM using a command line utility like '''wget'''. Since OpenKM 6.2.1 Community and OpenKM 6.2.5 Professional there is a service with BASIC authentication for this task. |
+ | Direct link need a '''user''' which have login grants. A good practice is configure the profile of this user to disallow anything. | ||
Available parameters: | Available parameters: | ||
Line 6: | Line 7: | ||
Example | Example | ||
− | http://'''user''':''' | + | http://'''user''':'''password'''@openkm_host/OpenKM/Download?'''uuid'''=4ca63b87-e340-443e-aeef-6c7e2fb57aea |
− | http://'''user''':''' | + | http://'''user''':'''password'''@openkm_host/OpenKM/Download?'''path'''=/okm:root/test/test.doc |
+ | |||
+ | This ease some integration tasks: | ||
+ | |||
+ | $ wget http://okmAdmin:admin@localhost:8080/OpenKM/Download?uuid=xxx-yyy-zzz | ||
+ | |||
+ | You can reference a document by UUID using the '''uuid''' parameter or by path, using the '''path''' parameter. In the same URL you need to specify the user and password. | ||
+ | |||
+ | [[Category: Utilities]] | ||
{{Note|If you use path parameter, ia good practice encode url to prevent problems with special characters}} | {{Note|If you use path parameter, ia good practice encode url to prevent problems with special characters}} |
Revision as of 13:16, 21 November 2012
You can download a document from OpenKM using a command line utility like wget. Since OpenKM 6.2.1 Community and OpenKM 6.2.5 Professional there is a service with BASIC authentication for this task. Direct link need a user which have login grants. A good practice is configure the profile of this user to disallow anything.
Available parameters:
- uuid ( the document UUID )
- path ( the document path )
Example
http://user:password@openkm_host/OpenKM/Download?uuid=4ca63b87-e340-443e-aeef-6c7e2fb57aea http://user:password@openkm_host/OpenKM/Download?path=/okm:root/test/test.doc
This ease some integration tasks:
$ wget http://okmAdmin:admin@localhost:8080/OpenKM/Download?uuid=xxx-yyy-zzz
You can reference a document by UUID using the uuid parameter or by path, using the path parameter. In the same URL you need to specify the user and password.
If you use path parameter, ia good practice encode url to prevent problems with special characters |