useridからopenidへの変換API

　微信支付、微信红包、振込を利用する場で、このAPIが必要になります。具体的には、企業号のuserをopenidに変換することです。微信红包機能を利用するときは、アプリケーションIDとuseridからアプリケーションIDとopenidを変換して利用可能になります。应用id和userid转成appid和openid才能使用。

リクエスト説明

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

リクエストボディ

{
   "userid": "zhangsan",
   "agentid": 1
}

パラメータ説明

パラメータ	必須	説明
access_token	Y	Access Token
userid	Y	企業号無いのでuserid
agentid	N	整数。红包を送信するときは必要。微信支付、企业振込の際は不要。

権限説明

メンバーがアプリケーションの参照権限内に所属していること。さらに管理グループがアプリケーション使用権限があること。メンバーは参照権限。

レスポンス結果

{
   "errcode": 0,
   "errmsg": "ok",
   "openid": "oDOGms-6yCnGrRovBj2yHij5JL6E",
   "appid":"wxf874e15f78cc84a7"
}

レスポンスパラメータ説明

パラメータ	説明
openid	企業号のuseridに対するopenid。agentidがリクエストパラメータにあれば、agentidのopenid。または企業号corpidのopenid。
appid	アプリケーションID。agentidがリクエストパラメータがなければ、本パラメーターは無い。

openidからuseridへの変換API

　微信支付、微信红包と企業振込を使用後の結果を確認する際に必要になります。開発者は、ある結果イベントのopenidが企業号ユーザの情報に対応する時、このAPIを利用します。

リクエスト説明

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

リクエストボディ

{
   "openid": "oDOGms-6yCnGrRovBj2yHij5JL6E"
}

パラメータ説明

パラメータ	必須	説明
openid	Y	微信支付、微信红包と企业振込の利用後に，帰ってくる結果openid返回

権限説明

管理グループがopenidに対する企業メンバーの参照権限を持っている事。

レスポンス結果

{
   "errcode": 0,
   "errmsg": "ok",
   "userid": "zhangsan"
}

レスポンスパラメータ説明

パラメータ	説明
userid	openidに対応したuserid

2016.08