Download
Last stable v 5.2 2024-11-01
API URL | /url/put |
Description | Create new or update CMS page info RESTFul API |
Access | Restricted to roles: admin, demo (r/o) |
Rquest method | POST |
Request data type | Request raw data |
Request data |
{
id: 'page id in DB table', // '' - when create new page
type: '0', // page type: 0 - regular, 1 - model, 2 - sample
mdl: '1', // 1 - page has assigned model page, 0 - not assigned model
mdl_id: '1', // assigned model page ID
title: 'page title',
title_full: 'page extended title', // ex. 'All samples related to something'
meta: {
desc: 'page description',
keyw: 'page keywords',
lang: 'page language id' // ex 'en'
},
dir_id: 'page folder id in DB table', // '' - if page update
pid: 'page pernament unique ID', // ex. '53d021ace89c4',
seq: "56704a4f7fd51", // unique SEQ
code: 'page type code', // ex. 'regular'
url: 'page URL', // ex. '/samples'
url_alias: [array of alias URL],
redirect: '0', // 0 - no redirect, 1 - redirect to another URL
redirect_url: '', // redirect URL, ex. 'http://www.google.com' if redirect=1
redirect_code: 'HTTP redirect code',
public: '1', // 1 - page public available, 0 - no public available
public_start: '0000-00-00 00:00:00', // when page public availability starts (if public=1)
public_stop: '9999-00-00 00:00:00', // when page public availability stops (if public=1)
tpl_key: '', // '' - if default template, 0 - template located in one of smarty template folders, 1 - template located in files sytems under '/cms/files'
tpl_title: '', // '' - if default template, template name if tpl_key=0, template file path if tpl_key=1
tpl_file: '', //'' - if default template, template file name if tpl_key=0, template file path if tpl_key=1
fnc: '', // '' - default URL routing function, 'class::function' - URL routing function (PHP class must be declared)
life: '', // page caching life time in sec
sitemap: '1', // 1 - include page into sitemap, 0 - don't include
sitemap_priority: '0.6', // page priority 0.0 ... 1.0
sitemap_frequency: '3', // page update frequency: 0 - always, 1 - hourly, 2 - daily, 3 - weekly, 4 - monthly, 5 - yearly, 6 - never
search: '1', // 1 - include page into search index, 0 - don't include
index: '1', // 1 - page include into full-text indexing and serach
boost: '1.0', // boost level for page in full-text search
top: ['topic_code', ...], // topic array
opt: [['2','','option text'], ...], // opttions array
onl: [['1', 'optional data id', 'optional data'], ...], // optional data array
method: '[]', // request method JSON array, ex. ["GET","POST"]
files: [['0', 'file id', 'file path', 'caching', 'life'], ...], // caching: '', 'caching', 'nocache', 'inline'; life: -1, 0-n (in secs)
css: [['type', '', 'file'], ...], // style sheet files, type: 0 - file path under '/cms/files', 1 - CMS config defined, 2 - external URL
js: [['type', '', 'file'], ...], // javascript files, type: 0 - file path under '/cms/files', 1 - CMS config defined, 2 - external URL
top_changed: '1', // 1 - topic data was changed, 0 - topic data remains unchanged
files_changed: '1', // 1 - files data was changed, 0 - files data remains unchanged
css_changed: '1', // 1 - css data was changed, 0 - css data remains unchanged
js_changed: '1', // 1 - js data was changed, 0 - js data remains unchanged
access_changed: '1', // 1 - access data was changed, 0 - access data remains unchanged
access: { // access control data
i: '1', // 1 - inheritance is alowed, 0 - inheritance is not alowed
r: { // read permission - actual only in Pages tool
g: ['group code', ...], // group/role permissions, ex. ['admin','demo']
u: ['user id', ...] // user permissions, ex. ['jsmi']
},
w: { // write permission - actual only in Pages tool
g: ['group code', ...],
u: ['user id', ...]
},
e:{ // execute permission - controls permission for page execution in browser
g: ['group code', ...],
u: ['user id', ...]
},
m:{ // manage permission - actual only in Pages tool
g: ['group code', ...],
u: ['user id', ...]
},
rep: '1' // 1 - replace access control data in all child nodes, 0 - do not replace
},
manage: '1', // '1' - current user has permissions to change access control data
data: [ //datastreams
[ // datastream
'data stream type', // types: '0' - storage, '1' - file, '2' - redirect
'data stream code', // ex. 'pdf'
'data stream ID', // ex. 'license'
'file path or URL', // ex. '/cms/files/license.pdf'
'mime type', // ex. 'application/pdf'
'file size', // ex. '284847'
'available via URL', // '1' - available, '0' - not available
'date, time of availability start', // ex. '0000-00-00 00:00:00'
'date, time of availability stop', // ex. '9999-00-00 00:00:00'
{
acl: { // access control list
i: '1', // 1 - inheritance is alowed, 0 - inheritance is not alowed
r: { // read permission - actual only in Pages tool
g: ['group code', ...], // group/role permissions, ex. ['admin','demo']
u: ['user id', ...] // user permissions, ex. ['jsmi']
},
w: { // write permission - actual only in Pages tool
g: ['group code', ...],
u: ['user id', ...]
},
e:{ // execute permission - controls permission for page execution in browser
g: ['group code', ...],
u: ['user id', ...]
},
m:{ // manage permission - actual only in Pages tool
g: ['group code', ...],
u: ['user id', ...]
},
inherit: '1', // 1 - inheritance is alowed, 0 - inheritance is not alowed
manage: '1' // 1 - ACL manage is alowed, 0 - ACL manage is not alowed
}
},
'XML metadata' // optional, ex. '<dc><identifier>aaa</identifier></dc>'
]
...
],
data_changed: '1' // '1' - datastream access control data is changed, '0' - datastream access control data is not changed
}
|
Response type | JSON |
Response data |
{
rc: 'return code', // '0' - success, '1' - error
msg: 'return message', // error message
data:[
key: 'page id in DB table', // ex. '1'
seq: '53d1015827a74',
pid: '53d1015827a37',
type: '0', // [0 | 1 | 2]
title: 'page title', // ex. 'demo'
url: 'page url', // ex. '/demo'
editor: 'last update editor name', // ex. 'Linkoln Edgar', '0' - if cms builtin administrator
timestamp: 'last update timestamp' // ex. '2013-09-02 15:04:33'
]
}
|