永久画像メッセージ素材アップロード

画像メッセージ素材アップロードをすると、APIは、素材リソースの識別ID:media_idを返します。media_idは再利用可能で、同じmedia_idで同じmedia_idを何度もメッセージ送信が出来ます。

リクエスト説明

HTTPSリクエストメソッド：POST
https://qyapi.weixin.qq.com/cgi-bin/material/add_mpnews?access_token=ACCESS_TOKEN

リクエストボディ

{
    "agentid":0,
    "mpnews":{
           "articles":[
            {
               "title": "Title01",
               "thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
               "author": "zs",
               "content_source_url": "",
               "content": "Content001",
               "digest": "airticle01",
               "show_cover_pic": "0"
              },
             {
               "title": "Title02",
               "thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7",
               "author": "Author001",
               "content_source_url": "",
               "content": "Content002",
               "digest": "article02",
               "show_cover_pic": "0"
             },
           //此处有多篇文章
            ]
    },
}

パラメータ説明

パラメータ	必須	説明
access_token	Y	Access Token
agentid	Y	アプリケーションID
articles	Y	画像メッセージ，一回のリクエストで最大10個の画像メッセージ送信可能。
title	Y	タイトル
thumb_media_id	Y	画像media_id, 永久素材アップロードAPIから取得。
author	N	作者
content_source_url	N	メッセージ内の“阅读原文”リンククリック後の遷移先URL
content	Y	内容。htmlタグ対応
digest	N	概要
show_cover_pic	N	カバー表示有無，1:表示，0:表示(デフォルト)

権限説明

管理グループの対象アプリケーションの利用権限，media_id同じアプリケーションの別管理グループでも利用可能。

レスポンス結果

{
   "errcode": "0",
   "errmsg": "ok",
   "media_id": "2-G6nrLmr5EC3MMfasdfb_-zK1dDdzmd0p7"
}

その他タイプ永久素材アップロード

画像、音声、映像などのメディアファイル並びに通常のファイル(例 doc, ppt)をアップロードすると、APIはリソースファイルの識別ID:media_idを返します。なお、media_idは再利用されるものど、同じmedia_idを何度もメッセージ送信が出来ます。に基づいています。

リクエスト説明

HTTPSリクエストメソッド：POST
https://qyapi.weixin.qq.com/cgi-bin/material/add_material?agentid=AGENTID&type=TYPE&access_token=ACCESS_TOKEN

パラメータ説明

パラメータ	必須	説明
access_token	Y	Access Token
type	Y	ファイルタイプ，image:画像、voice:音声、video:映像，file:通常ファイル
agentid	Y	アプリケーションID

リクエストボディ

一般的なマルチパートフォームデータ送信と同じ

権限説明

管理グループの対象アプリケーションの利用権限，media_id同じアプリケーションの別管理グループでも利用可能。

レスポンス結果

{
   "errcode":0,
   "errmsg":"ok",
   "media_id": "2-G6nrLmr5EFSDC3MMfasdfb_-zK1dDdzmd0p7"
}

永久素材アップロード制限

sizeは5byte以上
画像(image)：2MB, JPG, PNG形式
音声(voice)：2MB, 60秒以内。AMR形式
映像(video)：10MB, MP4形式
ファイル(file)：20MB
企業号内で、画像メッセージと画像素材の上限5000,その他で1000
最大量を超えるとエラーコード45028を返す

2016.06