電子發燒友App
二、出參規范：
1.查詢：
返回參數統一按如下接口形式，其中cnt為ad在數據庫中的總數目，如下面數據，ad下的list總數為2，area下的list總數為3。當接口有錯誤返回時，code大于1，且msg中含有錯誤信息，當無錯誤時，code為1，且msg為空。
當接口傳入當前頁參數p ，當前頁數據條數ps時，接口返回時，同樣也會反給客戶端p與ps參數。
如果有極端情況，即同一接口返回多個list，則接口分頁入參定義為“p+下劃線+當前list的下標”，如下接口，ad下的list中，當前頁的輸入參數為p_ad，ad的每頁條數輸入參數為ps_ad，即post或get中分頁參數為p_ad=1&ps_ad=20&p_area=1&ps_area=20
cnt不是當前list返回的條數，而是數據庫中，該list的總條數，用于分頁。
json格式示例：
{
“code”：1，
“msg”：“”，
“ad”：{
“cnt”：22，
“p”：2，
“ps”：20，
“list”：［{
“adv_title”：“\u8fd9\u662f\u5e7f\u544a\u6807\u98981”，
“adv_link”：“m.xxxxxx.cn\/advert\/tbsync\/”，
“open_target”：“2”，
“img_url”：“www.xxxxxx.cn\\\/data\\\/upload\\\/shop\\\/adv\\\/04825861373036910.png”
}，
{
“adv_title”：“\u8fd9\u662f\u5e7f\u544a\u6807\u98982”，
“adv_link”：“m.xxxxxx.cn\\\/advert\\\/newerDerate\\\/？430”，
“open_target”：“2”，
“img_url”：“www.xxxxxx.cn\\\/data\\\/upload\\\/shop\\\/adv\\\/04782825931526321.png”
}
］
}，
“area”：{
“cnt”：3，
“p”：1，
“ps”：20，
“list”：［{
“c_area_id”：“16”，“c_area_name”：“\u6df1\u5733”，
“c_area_pic”：“04732773115385188.jpg”，
“english_name”：“shenzhen”，“goodsCount”：“21”，
“img_url”：“www.xxxxxx.cn\\\/data\\\/upload\\\/shop\\\/adv\\\/04825861373036910.png”
}，
{
“c_area_id”：“18”，
“c_area_name”：“\u6e56\u5357”，
“c_area_pic”：“04732773115385188.jpg”，
“english_name”：“hunan”，
“goodsCount”：“33”，
“img_url”：“www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png”
}，
{
“c_area_id”：“2”，
“c_area_name”：“\u5317\u4eac”，
“c_area_pic”：“04732773115385188.jpg”，
“english_name”：“beijing”，“goodsCount”：“70”，
“img_url”：“www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png”
}
］
}，
“goods_info”：{
“cnt”：1，
“p”：1，
“ps”：20，
“list”：［{
“goods_id”：“211”，
“goods_name”：“\u5927\u4fdd\u5065\u5305\u591c”，
“goods_price”：“1000.00”，
“main_image”：“www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png”
}］
}
}
以php為示例，其中php中數組拼接格式為：
$array_data = array（
“code” =》 1，
“msg” =》 ‘’，
“ad” =》 array（
“cnt” =》 22，
“p” =》 2，
“ps” =》 20，
“list” =》 array（
0 =》 array（
“adv_title” =》 “這是廣告標題1”，
“adv_link” =》 “m.xxxxxx.cn/advert/tbsync/”，
“open_target” =》 “2”，
“img_url” =》 “www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png”
），
1 =》 array（
“adv_title” =》 “這是廣告標題2”，
“adv_link” =》 “m.xxxxxx.cn\/advert\/newerDerate\/？430”，
“open_target” =》 “2”，
“img_url” =》 “www.xxxxxx.cn\/data\/upload\/shop\/adv\/04782825931526321.png”
）
）
），
“area” =》 array（
“cnt” =》 3，
“p” =》 1，
“ps” =》 20，
“list” =》 array（
0 =》 array（
“c_area_id” =》 “16”，
“c_area_name” =》 “深圳”，
“c_area_pic” =》 “04732773115385188.jpg”，
“english_name” =》 “shenzhen”，
“goodsCount” =》 “21”，
“img_url” =》 “www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png”
），
1 =》 array（
“c_area_id” =》 “18”，
“c_area_name” =》 “湖南”，
“c_area_pic” =》 “04732773115385188.jpg”，
“english_name” =》 “hunan”，
“goodsCount” =》 “33”，
“img_url” =》 “www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png”
），
2 =》 array（
“c_area_id” =》 “2”，
“c_area_name” =》 “北京”，
“c_area_pic” =》 “04732773115385188.jpg”，
“english_name” =》 “beijing”，
“goodsCount” =》 “70”，
“img_url” =》 “www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png”
），
）
），
“goods_info” =》 array（
“cnt” =》 1，
“p” =》 1，
“ps” =》 20，
“list” =》 array（
0 =》 array（
“goods_id” =》 “211”，
“goods_name” =》 “大保健包夜”，
“goods_price” =》 “1000.00”，
“main_image” =》 “www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png”
）
）
）
）;
接口盡量按一個頁面一個接口，但是公用的一些接口信息，如地區分類信息等，做單獨接口處理，但是結果參數規范，按照上面數據格式返回數據。
返回的xml數據格式，如下：
《？xml version=“1.0” encoding=“utf-8”？》
《data》
《code》1《/code》
《msg/》
《ad》
《cnt》22《/cnt》
《p》2《/p》
《ps》20《/ps》
《list》
《article》
《advtitle》這是廣告標題1《/advtitle》
《advlink》m.xxxxxx.cn/advert/tbsync/《/advlink》
《opentarget》2《/opentarget》
《imgurl》www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png《/imgurl》
《/article》
《article》
《advtitle》這是廣告標題2《/advtitle》
《advlink》m.xxxxxx.cn\/advert\/newerDerate\/？430《/advlink》
《opentarget》2《/opentarget》
《imgurl》www.xxxxxx.cn\/data\/upload\/shop\/adv\/04782825931526321.png《/imgurl》
《/article》
《/list》
《/ad》
《area》
《cnt》3《/cnt》
《p》1《/p》
《ps》20《/ps》
《list》
《article》
《careaid》16《/careaid》
《careaname》深圳《/careaname》
《careapic》04732773115385188.jpg《/careapic》
《englishname》shenzhen《/englishname》
《goodsCount》21《/goodsCount》
《imgurl》www.xxxxxx.cn\/data\/upload\/shop\/adv\/04825861373036910.png《/imgurl》
《/article》
《article》
《careaid》18《/careaid》
《careaname》湖南《/careaname》
《careapic》04732773115385188.jpg《/careapic》
《englishname》hunan《/englishname》
《goodsCount》33《/goodsCount》
《imgurl》www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png《/imgurl》
《/article》
《article》
《careaid》2《/careaid》
《careaname》北京《/careaname》
《careapic》04732773115385188.jpg《/careapic》
《englishname》beijing《/englishname》
《goodsCount》70《/goodsCount》
《imgurl》www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png《/imgurl》
《/article》
《/list》
《/area》
《goodsinfo》
《cnt》1《/cnt》
《p》1《/p》
《ps》20《/ps》
《list》
《article》
《goodsid》211《/goodsid》
《goodsname》大保健包夜《/goodsname》
《goodsprice》1000.00《/goodsprice》
《mainimage》www.xxxxxx.cn/data/upload/shop/adv/04825861373036910.png《/mainimage》
《/article》
《/list》
《/goodsinfo》
《/data》
其中list中的數字下標用article代替，附php版本自定義的遞歸數組轉xml函數：
function ArrtoXml（$data， $rootNodeName = ‘data’， $xml=null）
{
// turn off compatibility mode as simple xml throws a wobbly if you don‘t.
if （ini_get（’zend.ze1_compatibility_mode‘） == 1）
{
ini_set （’zend.ze1_compatibility_mode‘， 0）;
}
if （$xml == null）
{
$xml = simplexml_load_string（“《？xml version=’1.0‘ encoding=’utf-8‘？》《$rootNodeName /》”）;
}
// loop through the data passed in.
foreach（$data as $key =》 $value）
{
// no numeric keys in our xml please！
if （is_numeric（$key））
{
// make string key.。.
$key = “article”。 （string） $key;
}
// replace anything not alpha numeric
$key = preg_replace（’/［^a-z］/i‘， ’‘， $key）;
// if there is another array found recrusively call this function
if （is_array（$value））
{
$node = $xml-》addChild（$key）;
// recrusive call.
ArrtoXml（$value， $rootNodeName， $node）;
}
else
{
// add single node.
$value = htmlentities（$value）;
$xml-》addChild（$key，$value）;
}
}
// pass back as string. or simple xml object if you want！
return $xml-》asXML（）;
}
注意事項：
當返回js時，即data_type=js，在json串前加入 RESULT=，即格式為RESULT={json串}。
當返回html時，即data_type=html，在返回的字符串中加入html頭部，即DOCTYPE、HEAD、BODY等信息。
2.添加，修改，刪除
當調用增刪改數據接口時，code為1時表操作成功，當code大于1時，表示操作失敗，并在msg中返回錯誤信息，如下：
{
“code”：101，
“msg”：“操作參數丟失！”
}
當然，若增刪改后仍然需要返回響應數據，格式同查詢。
工商網監
評論