標(biāo)簽作用:用于遠(yuǎn)程調(diào)取系統(tǒng)數(shù)據(jù),使用小程序、公眾號(hào)、APP等。
1)請(qǐng)先到后臺(tái)進(jìn)行API相關(guān)參數(shù)配置,強(qiáng)烈建議啟用強(qiáng)制認(rèn)證;
2)客戶端發(fā)起請(qǐng)求必須包含appid(認(rèn)證用戶)、timestamp(時(shí)間戳)、signature(簽名)三個(gè)參數(shù)
3)簽名參數(shù)signature通過appid、secret、timestamp三個(gè)值連接為一個(gè)字符串,然后進(jìn)行雙層md5加密生成;
<script>
$(document).ready(function (e) {
var url='/api.php/cms/site';
$.ajax({
type: 'POST',
url: url,
dataType: 'json',
data: {
appid: '{pboot:appid}',
timestamp: '{pboot:timestamp}',
signature: '{pboot:signature}'
},
success: function (response, status) {
if(response.code){
//獲取數(shù)據(jù)成功
alert(response.data.title);
}else{
//返回錯(cuò)誤數(shù)據(jù)
alert(response.data);
}
},
error:function(xhr,status,error){
//返回?cái)?shù)據(jù)異常
alert('返回?cái)?shù)據(jù)異常!');
}
});
});
</script>
此處使用了三個(gè)站內(nèi)標(biāo)簽:{pboot:appid} 認(rèn)證用戶名、{pboot:timestamp} 時(shí)間戳、{pboot:signature} 認(rèn)證簽名
http://IP/api.php/cms/site
http://IP/api.php/cms/site/name/* 單個(gè)調(diào)用
注意此處和CMS標(biāo)簽比不帶site前綴,所以返回整體數(shù)據(jù)和調(diào)取單個(gè)時(shí)直接寫名稱,如:標(biāo)題title
http://IP/api.php/cms/company
http://IP/api.php/cms/company/name/* 單個(gè)調(diào)用
注意此處和CMS標(biāo)簽比不帶company前綴,所以返回整體數(shù)據(jù)和調(diào)取單個(gè)時(shí)直接寫名稱,如:名稱name
http://IP/api.php/cms/label
http://IP/api.php/cms/label/name/* 單個(gè)調(diào)用
http://IP/api.php/cms/nav
http://IP/api.php/cms/nav/scode/* 獲取指定分類的子類
http://IP/api.php/cms/position/scode/* 此處傳遞當(dāng)前欄目scode值
http://IP/api.php/cms/sort/scode/* 此處傳遞需要調(diào)用欄目的scode值
http://IP/api.php/cms/pics/id/* 此處傳遞內(nèi)容ID值
http://IP/api.php/cms/slide/gid/*/num/* 此處傳遞分組gid及調(diào)取的數(shù)量num值,默認(rèn)num為5
http://IP/api.php/cms/link/gid/*/num/* 此處傳遞分組gid及調(diào)取的數(shù)量num值,默認(rèn)num為10
http://IP/api.php/list/* 此處傳遞需要調(diào)用的欄目scode
http://IP/api.php/list/*/page/2 調(diào)取第二頁,如果數(shù)據(jù)已獲取完,返回類似{"code":0,"data":"已經(jīng)到底了!","rowtotal":"5"}
同時(shí)還支持URL中傳遞num/*參數(shù)控制數(shù)量,傳遞order/* 控制排序方式,用POST方式會(huì)更好傳遞值
http://IP/api.php/content/* 傳遞需要調(diào)用的內(nèi)容ID(單頁一樣適用)
http://IP/api.php/about/* 傳遞需要調(diào)用的單頁scode
http://IP/api.php/cms/search 建議使用POST提交,keyword傳遞搜索關(guān)鍵字單條件搜索
同時(shí)支持傳遞num/*參數(shù)控制數(shù)量,傳遞order/* 控制排序方式,建議POST方式
可傳遞參數(shù) field指定字段,多個(gè)用|隔開;
可傳遞參數(shù) scode指定分類,多個(gè)用逗號(hào)隔開;
可傳遞參數(shù) fuzzy等于0關(guān)閉模糊匹配,另外也可使用多數(shù)據(jù)庫字段名稱傳遞值來多條件搜索
http://IP/api.php/cms/addmsg 要求POST提交,傳遞的字段同后臺(tái)自定義的留言字段
http://IP/api.php/cms/msg/num/* 傳遞num分頁大小
http://IP/api.php/cms/msg/num/*/page/2 調(diào)取第二頁
http://IP/api.php/cms/addform/fcode/* 要求POST提交,fcode為表單編碼,傳遞的字段同后臺(tái)自定義的字段
http://IP/api.php/cms/form/fcode/* 傳遞fcode表單編碼
http://IP/api.php/cms/form/fcode/*/num/*/page/* num控制條數(shù),page控制頁碼
以上接口對(duì)于多語言(區(qū)域)的情況,請(qǐng)地址中附加acode參數(shù)指定語言,否則調(diào)用默認(rèn)語言,如:http://IP/api.php/cms/site/acode/en
教程內(nèi)容BUG提交
提交