WeChat ミニ プログラム API 一時マテリアル インターフェイス

一時マテリアル インターフェイス

一時マテリアルの取得

アプレットは、このインターフェイスを使用して、カスタマー サービス メッセージ内の一時マテリアルを取得できます (つまり、一時マルチメディア ファイルをダウンロードします)。現在、ミニ プログラムは画像ファイルのダウンロードのみをサポートしています。

インターフェース呼び出しリクエストの説明

HTTPリクエストメソッド: GET、HTTPSコール

https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

リクエストの例(例はcurlコマンドを介してマルチメディアファイルを取得するものです)

curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

パラメータの説明

説明を返す

大文字と小文字を区別してHTTPを返すヘッダーは次のとおりです

HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg 
Content-disposition: attachment; filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan 2013 10:20:18 GMTCache-Control: no-cache, must-revalidateContent-Length: 339721curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

ビデオメッセージ素材が返された場合、内容は次のとおりです:

{
 "video_url":DOWN_URL
}

エラー状況で返されるJSONデータパケットの例は次のとおりです(例は無効なメディアIDエラーです):

{ 
 "errcode":40007,  "errmsg":"invalid media_id"
 }

新しい一時マテリアル

アプレットは、このインターフェイスを使用してメディア ファイルを保存できます (現在は画像のみがサポートされています) WeChat サーバーにアップロードすると、ユーザーはカスタマー サービス メッセージを送信するか、ユーザー メッセージに受動的に返信します。

インターフェース呼び出しリクエストの説明

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"

パラメータの説明

Return説明

正しい場合に返された JSON データ パケットの結果は次のとおりです:

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

間違った場合に返された JSON データ パケットの例は次のとおりです (例は無効なメディア タイプ エラーです)。