post請求案例：post from 表單的案例

 

post請求案例：post from  表單的案例

1.搜索群發接口，點擊

 2.點擊 預覽接口【訂閱號與服務號認證后均可用】

 

3.預覽接口【訂閱號與服務號認證后均可用】

開發者可通過該接口發送消息給指定用戶，在手機端查看消息的樣式和排版。為了滿足第三方平台開發者的需求，在保留對openID預覽能力的同時，增加了對指定微信號發送預覽的能力，但該能力每日調用次數有限制（100次），請勿濫用。

接口調用請求說明

http請求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN

POST數據說明

POST數據示例如下：

圖文消息（其中media_id與根據分組群發中的media_id相同）：

{
   "touser":"OPENID", 
   "mpnews":{              
     "media_id":"123dsdajkasd231jhksad"               
    },
   "msgtype":"mpnews" 
}

文本：

{     
    "touser":"OPENID",
    "text":{           
      "content":"CONTENT"            
    },     
    "msgtype":"text"
}

語音（其中media_id與根據分組群發中的media_id相同）：

{
    "touser":"OPENID",
    "voice":{              
     "media_id":"123dsdajkasd231jhksad"
    },
    "msgtype":"voice" 
}

圖片（其中media_id與根據分組群發中的media_id相同）：

{
    "touser":"OPENID",
    "image":{      
     "media_id":"123dsdajkasd231jhksad"
    },
    "msgtype":"image" 
}

視頻（其中media_id與根據分組群發中的media_id相同）：

{
    "touser":"OPENID",
    "mpvideo":{  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",   
   },
    "msgtype":"mpvideo" 
}

卡券：

{ "touser":"OPENID", 
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad",
            "card_ext": "{"code":"","openid":"","timestamp":"1402057159","signature":"017bb17407c8e0058a66d72dcc61632b70f511ad"}"               
            }, 
  "msgtype":"wxcard" 
}

請注意，上述JSON數據中的touser字段都可以改為towxname，這樣就可以針對微信號進行預覽（而非openID），towxname和touser同時賦值時，以towxname優先。修改后JSON數據如下（以圖文消息為例）： 圖文消息：

{
   "towxname":"示例的微信號", 
   "mpnews":{              
            "media_id":"123dsdajkasd231jhksad"               
             },
   "msgtype":"mpnews" 
}

參數	說明
touser	接收消息用戶對應該公眾號的openid，該字段也可以改為towxname，以實現對微信號的預覽
msgtype	群發的消息類型，圖文消息為mpnews，文本消息為text，語音為voice，音樂為music，圖片為image，視頻為video，卡券為wxcard
media_id	用於群發的消息的media_id
content	發送文本消息時文本的內容

返回說明

返回數據示例（正確時的JSON返回結果）：

{
   "errcode":0,
   "errmsg":"preview success",
   "msg_id":34182
}

參數	說明
errcode	錯誤碼
errmsg	錯誤信息
msg_id	消息ID

4.調用接口

 

想推送一條圖片消息，需要openid，下圖的微信號就是openid

 

想推送一條圖片消息，需要media_id

1.

 

接口調用請求說明

http請求方式：POST/FORM，使用https
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
調用示例（使用curl命令，用FORM表單方式上傳一個多媒體文件）：
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

參數說明

參數	是否必須	說明
access_token	是	調用接口憑證
type	是	媒體文件類型，分別有圖片（image）、語音（voice）、視頻（video）和縮略圖（thumb）
media	是	form-data中媒體文件標識，有filename、filelength、content-type等信息

返回說明

正確情況下的返回JSON數據包結果如下：

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

參數	描述
type	媒體文件類型，分別有圖片（image）、語音（voice）、視頻（video）和縮略圖（thumb，主要用於視頻與音樂格式的縮略圖）
media_id	媒體文件上傳后，獲取標識
created_at	媒體文件上傳時間戳

錯誤情況下的返回JSON數據包示例如下（示例為無效媒體類型錯誤）：

{"errcode":40004,"errmsg":"invalid media type"}

 

調用接口