## **接口內容列表**
[TOC]
## **上傳臨時素材（有效期為3天）**
* 參數`$data`內容為文件地址`{"media":'@Path\filename.jpg'}`
* 參數`$type`為素材類型，可選有圖片`image`、語音`voice`、視頻`video`、縮略圖`thumb`
* 素材上傳完成后，會反回素材對應的`media_id`
~~~
// 創建SDK實例
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadMedia($data,$type);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **獲取臨時微信素材**
* 參數`$media_id`為素材的`media_id`
* 參數`$is_video`指定是否為視頻素材（默認`false`）
* 注意：返回圖文消息數組或二進制數據，失敗返回false
~~~
// 創建SDK實例
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->getMedia($media_id, $is_video);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **上傳圖片到微信服務器（不占用素材資源數據）**
* 參數`$data`為文件數據`{"media":'@Path\filename.jpg'}`
* 注意：這里返回的是圖片的URL地址，不再是`media_id`
~~~
// 創建SDK實例
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadImg($data);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **上傳永久素材到微信服務器**
* 參數`$data`為文件數據`{"media":'@Path\filename.jpg'}`
* 參數`$type`為素材類型，可選有圖片`image`、語音`voice`、視頻`video`、縮略圖`thumb`
* 參數`$is_video`為是否為視頻文件（默認為否）
* 參數`$video_info`為視頻信息數組，非視頻素材不需要提供 array('title'=>'視頻標題','introduction'=>'描述')
* 素材上傳完成后，會反回素材對應的`media_id`
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadForeverMedia($data, $type, $is_video, $video_info);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **上傳永久圖文素材到微信服務器**
* 參數`$data`為圖文數據`{"articles":[{...}]}`
* 圖文上傳完成后，會反回素材對應的`media_id`
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadForeverArticles($data);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **修改永久微信圖文素材**
* 參數`$media_id`為文圖文素材id
* 參數`$data`為文章內容`{"articles":[{...}]}`
* 參數`$index`為更新的文章在圖文素材的位置，第一篇為0，僅多圖文使用
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->updateForeverArticles($media_id, $data, $index);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **獲取永久素材**
* 參數`$media_id`為素材的`media_id`
* 參數`$is_video`指定是否為視頻素材（默認`false`）
* 注意：返回圖文消息數組或二進制數據，失敗返回false
~~~
// 創建SDK實例
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->getForeverMedia($media_id, $is_video);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **刪除永久素材**
* 參數`$media_id`為媒體文件id
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->delForeverMedia($media_id);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **獲取永久素材列表**
* 參數`$type`為素材類型，可選有圖片`image`、語音`voice`、視頻`video`、縮略圖`thumb`
* 參數`$offset`為全部素材的偏移位置（0表示從第一個素材）
* 參數`$count`為返回素材的數量，取值在1到20之間
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->getForeverList($type, $offset, $count);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **獲取永久素材總數**
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->getForeverCount();
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **上傳圖文消息素材（用于群發）**
* 參數`$data`為圖文數據`{"articles":[{...}]}`
* 圖文上傳完成后，會反回素材對應的`media_id`
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadArticles($data);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **上傳視頻素材**
* 參數`$data`為視頻數據`{"media_id":"", "title":"TITLE","description":"Description"}`
* 視頻上傳成功后，會返回`{"type":"video","media_id":"mediaid","created_at":1398848981}`
~~~
// 實例微信接口
$media = & load_wechat('Media');
// 執行接口操作
$result = $media->uploadMpVideo($data);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
## **微信圖文消息推送**
* 參數`$data`為圖文數據包，格式可以參數微信官方文檔
~~~
// 實例微信接口
$wechat = &load_wechat('Receive');
// 執行接口操作
$result = $wechat->sendGroupMassMessage($data);
// 處理執行的結果
if($result===FALSE){
// 接口失敗的處理
echo $media->errMsg;
}else{
// 接口成功的處理
}
~~~
