Wechat

Wechat API wrapper in Elixir.

Warning: The project is under active development, don't use in production env.

Installation

  def deps do
    [{:wechat, "~> 0.3.0"}]
  end

Config

• Add config in config.exs

    config :wechat,
      appid: "wechat app id",
      secret: "wechat app secret",
      token: "wechat token",
      encoding_aes_key: "32bits key" # 只有"兼容模式"和"安全模式"才需要配置这个值

Usage

• access_token

    iex> Wechat.access_token
    "Bgw6_cMvFrE3hY3J8U6oglhvlzHhMpAQma0Wjam4XsLx8F6XP4pfZzsezBdpfth2BNAdUK6wA23S7D3fSePt7meG9a1gf9LhEmXjxGelnTjJLaIQMYumrCHE_9gcFVXaHIHcAGACDC"

• user

    iex> Wechat.User.get
    %{count: 4,
    data: %{openid: ["oi00OuFrmNEC-QMa0Kikycq6A7ys",
     "oi00OuKAhA8bm5okpaIDs7WmUZr4", "oi00OuOdjK0TicVUmovudbSP5Zq4",
     "oi00OuBgG2mko_pOukCy00EYCwo4"]},
    next_openid: "oi00OuBgG2mko_pOukCy00EYCwo4", total: 4}
  
    iex> Wechat.User.info("oi00OuKAhA8bm5okpaIDs7WmUZr4")
    %{city: "宝山", country: "中国", groupid: 0,
    headimgurl: "http://wx.qlogo.cn/mmopen/7raJSSs9gLVJibia6sAXRvr8jajXfQFWiagrLwrRIZjMHCEXOxYf6nflxcpl4WkT7gz8Sa4tO32avnI0dlNLn24yA/0",
    language: "zh_CN", nickname: "小爆炸的爸爸",
    openid: "oi00OuKAhA8bm5okpaIDs7WmUZr4", province: "上海", remark: "",
    sex: 1, subscribe: 1, subscribe_time: 1449812483, tagid_list: [],
    unionid: "o2oUsuOUzgNL-JSLtIp8b3FzkI-M"}

• media

    iex> file = Wechat.Media.download("GuSq91L0FXQFOIFtKwX2i5UPXH9QKnnu63_z4JHZwIw3TMIn1C-xm8hX3nPWCA")
   iex> File.write!('/tmp/file', file)

Plug Usage (in Phonenix controller)

• router.ex

    defmodule MyApp.Router do
      pipeline :api do
        plug :accepts, ["json"]
      end
  
      scope "/wechat", MyApp do
        pipe_through :api
  
        # validate wechat server config
        get "/", WechatController, :index
  
        # receive wechat push message
        post "/", WechatController, :create
      end
    end

• wechat_controller.ex

    defmodule MyApp.WechatController do
      use MyApp.Web, :controller
  
      plug Wechat.Plugs.RequestValidator
      plug Wechat.Plugs.MessageParser when action in [:create]
  
      def index(conn, %{"echostr" => echostr}) do
        text conn, echostr
      end
  
      def create(conn, _params) do
        msg = conn.body_params
        reply = build_text_reply(msg, msg.content)
        render conn, "text.xml", reply: reply
      end
  
      defp build_text_reply(%{"ToUserName" => to, "FromUserName" => from}, content) do
        %{from: to, to: from, content: content}
      end
    end

• text.xml.eex

    <xml>
      <MsgType><![CDATA[text]]></MsgType>
      <Content><![CDATA[<%= @reply.content %>]]></Content>
      <ToUserName><![CDATA[<%= @reply.to %>]]></ToUserName>
      <FromUserName><![CDATA[<%= @reply.from %>]]></FromUserName>
      <CreateTime><%= DateTime.to_unix(DateTime.utc_now) %></CreateTime>
    </xml>