/*本文為php版本的接口開(kāi)發(fā)文檔，其他語(yǔ)言文檔后續陸續推出，敬請關(guān)注。*/

?本文主要講述優(yōu)采云接口文檔的基本結構，讓用戶(hù)和開(kāi)發(fā)者能夠根據需要進(jìn)行接口開(kāi)發(fā)和修改。

接口文件組成

• 鑒權接口（ucaiyun_Signature.php）
• 發(fā)布接口（ucaiyun_Savearticle.php）

　　兩個(gè)接口文件必須同時(shí)放在網(wǎng)站根目錄方能生效，且文件名不可修改。ucaiyun_Signature.php為優(yōu)采云推送時(shí)直接訪(fǎng)問(wèn)的文件。ucaiyun_Savearticle.php，只被鑒權接口以include的形式運行，不直接被訪(fǎng)問(wèn)。

鑒權接口
　　優(yōu)采云平臺為每個(gè)網(wǎng)站生成唯一的安全憑證，安全憑證包括apiname和apipass，用于在用戶(hù)網(wǎng)站和優(yōu)采云平臺之間相互通信時(shí)進(jìn)行簽名驗證，簽名使用?HMAC-SHA1 算法。安全憑證、相關(guān)簽名和鑒權算法都包含在ucaiyun_Signature.php文件中。
　　ucaiyun_Signature.php文件除進(jìn)行鑒權外，還負責與優(yōu)采云服務(wù)器通信，并將返回的文章相關(guān)字段以數組形式發(fā)送給發(fā)布接口。
　　鑒權接口通常無(wú)需修改，適用于任何php程序。
?
發(fā)布接口
　　此接口用于把文章信息保存到網(wǎng)站數據庫，并根據用戶(hù)設置，進(jìn)行生成靜態(tài)、圖片處理、自動(dòng)內鏈、百度推送等操作。此接口文件中，開(kāi)發(fā)者擁有完全的自由，可進(jìn)行任意的操作。
?
字段說(shuō)明
　　鑒權接口將文章信息發(fā)送到發(fā)布接口，在發(fā)布接口中直接以$article數組調用。所有字段說(shuō)明如下：

$article['arc_body']          /*文章正文*/

$article['arc_title']         /*文章標題*/

$article['arc_tags']          /*文章tags*/

$article['arc_writer']        /*用于顯示的文章作者*/

$article['arc_source']        /*用于顯示的文章來(lái)源*/

$article['arc_keywords']      /*文章關(guān)鍵詞*/

$article['arc_description']   /*文章描述*/

        

$article['typeid']            /*文章對應站內欄目id*/

$article['source_keyword']    /*采集該文章使用的關(guān)鍵詞*/

$article['source_link']       /*該文章采集自此鏈接*/

        

$article['auto_flag']         /*需要自動(dòng)獲取的文章屬性*/

$article['download_pic']      /*圖片處理方式：下載到服務(wù)器(1) 遠程網(wǎng)址(0) 屏蔽圖片(-1)*/

$article['arcrank']           /*是否自動(dòng)審核 是(1) 否(0)*/

$article['ismake']            /*是否生成靜態(tài) 是(1) 否(0)*/

$article['makeindex']         /*是否生成首頁(yè) 是(1) 否(0)*/

$article['makelist']          /*是否生成欄目和列表頁(yè) 是(1) 否(0)*/

$article['auto_sp_size']      /*自動(dòng)分頁(yè)大小 計算時(shí)應當算字符數，而非字節*/

$article['auto_inner_link']   /*是否自動(dòng)內鏈 是(1) 否(0)*/



$article['baidutoken']        /*百度主動(dòng)推送token*/

$article['fromcharset']       /*優(yōu)采云平臺的字符編碼(UTF-8)*/

$article['mycharset']         /*目標網(wǎng)站設置的字符編碼*/

編碼說(shuō)明

• $article數組已自動(dòng)轉換為目標網(wǎng)站編碼（$article['mycharset']），請勿重復轉換。
• 接口文件編碼為UTF-8、GBK、GB2312均可，默認為UTF-8，通常無(wú)需修改。
• 發(fā)布接口ucaiyun_Savearticle.php中如涉及中文字符及標點(diǎn)插入到文章任何部分進(jìn)入數據庫，請轉換到對應編碼。如涉及有消息輸出到前臺，盡量使用英文，或將編碼轉換到與鑒權接口一致。

?
開(kāi)始開(kāi)發(fā)
　　在ucaiyun_Savearticle.php中，直接使用$article變量獲取返回的文章信息數組。注意，該數組中所有字段已自動(dòng)轉換為目標網(wǎng)站在優(yōu)采云控制臺設置的編碼，請勿重復轉換。以下代碼：

<?php

file_put_contents('log.txt',var_export($article,true),FILE_APPEND);

?>

保存到ucaiyun_Savearticle.php后，每次收到文章時(shí)，會(huì )自動(dòng)輸出$article數組到log.txt文件中。
?
開(kāi)發(fā)進(jìn)階
　　為防止發(fā)布文檔被其他文件錯誤調用，建議進(jìn)行環(huán)境判斷：

if (!defined('IN_CAIJIAPI')) exit;    /*IN_CAIJIAPI已在鑒權接口中定義*/

　　為保證文章不會(huì )因為運行時(shí)間太長(cháng)而丟失，建議不限php運行時(shí)間：

@set_time_limit(0);

　　為保證在前端意外斷開(kāi)時(shí)，程序會(huì )繼續執行直至文章保存完成，建議忽略用戶(hù)退出：

@ignore_user_abort(true);

　　接下來(lái)就可以進(jìn)行相關(guān)處理操作，注意在寫(xiě)入數據庫前做好安全檢查。
　　通常在保存文章之前應當執行以下處理：

• 圖片處理
• 賦予文章自動(dòng)屬性
• 自動(dòng)分頁(yè)
• 自動(dòng)內鏈

　　在保存文章之后應當執行以下處理：

• tags保存和關(guān)聯(lián)
• 生成靜態(tài)
• 百度主動(dòng)推送

?建議發(fā)布接口按以下代碼框架進(jìn)行設計：

//判斷運行環(huán)境

if (!defined('IN_CAIJIAPI')) exit;



//關(guān)閉錯誤提示

@ini_set('display_errors', '0');

error_reporting(0);



//不限運行時(shí)間

@set_time_limit(0);



//客戶(hù)端退出后繼續運行

@ignore_user_abort(true);



//此處引入程序公共文件

//以及設置一些必要參數



class SaveArticle{

	var $article;

	function SaveArticle($arc){

		$this->__construct($arc);

	}

	function __construct($arc){

		$this->article = $arc;

	}

	function run(){

        //在保存文章前，執行圖片本地化

		$this->downloadImages();

        

        //在保存文章前，執行內容分頁(yè)

		$this->splitPage();

        

        //在保存文章前，執行自動(dòng)內鏈

		$this->setInnerLink();

        

        //此處保存文章，具體邏輯根據您的需求和程序邏輯來(lái)寫(xiě)

        

        //生成文章靜態(tài)頁(yè)面

		$this->makeHtml();

        

        //把文章網(wǎng)址推送給百度

		$this->baiduPush();



        //返回此消息給優(yōu)采云，表示文章保存完成

		echo 'Article Saved!';

	}

	function downloadImages(){

	}

    

	function splitPage(){

	}



	function setInnerLink(){

	}

    

	function makeHtml(){

	}

    

 	function baiduPush(){

	}

}

$SaveArticle = new SaveArticle($article);

$SaveArticle->run();

以上所有形式都只是推薦而非強制，只要保證能夠正常接收和保存文章，任何形式的接口都是可以的。有任何問(wèn)題，請在接口開(kāi)發(fā)板塊提出，或在本文檔留言，歡迎踴躍討論。
?
另：優(yōu)采云官方5000積分收購不同程序的接口文檔，有意請聯(lián)系管理員。