[DMM Mobile]WebAPI仕様:利用可能な高速通信量の確認

2016年1月30日

DMMのNVMO SIMに対する、利用可能な高速通信データ残量や追加容量チャージのクーポン情報取得に関するWebAPIの仕様です。


Mvno_List.GetCoupon:クーポン一覧問合せ


Resuest：

使用している端末がAndroidの場合は、URLに”method=AndroidApp”、POSTパラメータのappidにandroid_mvnoをセットする。messageに要求APIを指定する。

POST https://www.dmm.com/service/-/json/=/method=AndroidApp HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Host: www.dmm.com
Connection: Keep-Alive
Accept-Encoding: gzip
 
[POST Params]
authkey %AUTH_KEY%
appid   android_mvno
message Mvno_List.GetCoupon
params  {}




Response:

応答データは、JSON形式で返される
data/coupon_info/data_priceは税抜き金額、data_price_fullには税込金額がセットされる。
data/coupon_info/is_onetimeがfalseのレコードは、複数回適用可能
exectimeは秒単位でセットされる

{
    "event": true,
    "data": {
        "coupon_info": [{
            "id": "1",
            "coupon": "100",
            "charge_id": "17",
            "data_product_id": "mvno_add_00100",
            "data_charge_name": "追加チャージ100MB",
            "data_price": "200",
            "data_price_full": "216",
            "is_onetime": false
        }, {
            "id": "2",
            "coupon": "500",
            "charge_id": "18",
            "data_product_id": "mvno_add_00500",
            "data_charge_name": "追加チャージ500MB",
            "data_price": "600",
            "data_price_full": "648",
            "is_onetime": false
        }, {
            "id": "3",
            "coupon": "1000",
            "charge_id": "19",
            "data_product_id": "mvno_add_01000",
            "data_charge_name": "追加チャージ1000MB",
            "data_price": "1100",
            "data_price_full": "1188",
            "is_onetime": false
        }, {
            "id": "4",
            "coupon": "1000",
            "charge_id": "77",
            "data_product_id": "mvno_add_onetime_01000",
            "data_charge_name": "追加チャージ1000MB※繰り越しなし",
            "data_price": "480",
            "data_price_full": "518",
            "is_onetime": true
        }]
    },
    "exectime": 0.0074,
    "memory": "1,532,128"
}





Mvno_IijConnect.GetCouponStatus:クーポンステータス問合せ


Resuest：

messageにAPI名”Mvno_IijConnect.GetCouponStatus”を指定する

POST https://www.dmm.com/service/-/json/=/method=AndroidApp HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Host: www.dmm.com
Connection: Keep-Alive
Accept-Encoding: gzip
 
[POST Params]
authkey %AUTH_KEY%
appid   android_mvno
message Mvno_IijConnect.GetCouponStatus
params  {"access_token":"%ACC_TOKEN%","kpg_code":"kpg%KPG_CODE%"}




Response:

正常終了の場合、data/statusに200がセットされる

{
    "event": true,
    "data": {
        "status": "200",
        "coupon_status": true
    },
    "exectime": 1.329,
    "memory": "1,532,640"
}





Mvno_IijConnect.GetCouponAmount:残高速通信量問合せ


Resuest：

messageにAPI名”Mvno_IijConnect.GetCouponAmount”を指定する

POST https://www.dmm.com/service/-/json/=/method=AndroidApp HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Host: www.dmm.com
Connection: Keep-Alive
Accept-Encoding: gzip
 
[POST Params]
authkey %AUTH_KEY%
appid   android_mvno
message Mvno_IijConnect.GetCouponAmount
params  {"access_token":"%ACC_TOKEN%","kpg_code":"kpg%KPG_CODE%"}




Response:

bundle_couponに、契約プランがセットされる(3GBプランの場合は3000がセットされる)
coupon_amountに、利用可能な高速通信量がMB単位でセットされる
coupon_amount_detailは、利用期限毎の通信容量が指定される。
毎月付与される通信クーポンは翌月末まで有効なため、2/1に付与されるクーポンの期限は3/31となる。

{
    "event": true,
    "data": {
        "status": "200",
        "bundle_coupon": "3000",
        "coupon_amount": 1930,
        "coupon_amount_detail": [{
            "Expiration": "20160131",
            "Coupon": "0"
        }, {
            "Expiration": "20160229",
            "Coupon": "1930"
        }, {
            "Expiration": "20160331",
            "Coupon": "0"
        }, {
            "Expiration": "20160430",
            "Coupon": "0"
        }]
    },
    "exectime": 0.8132,
    "memory": "1,432,412"
}








その他API/WebサイトURL


請求内容ページ：　https://mvno.dmm.com/mypage/-/status/log/?mvnoga=billing

高速データ通信残量通知：　https://mvno.dmm.com/mypage/-/notification/?mvnoga=notice

チャージ履歴：　https://mvno.dmm.com/mypage/-/charge/log/

よくある質問：　http://help.dmm.com/-/list/=/mid=521/

高速通信のON/OFF制御： https://www.dmm.com/service/-/json/=/method=AndroidApp

messageにAPI名"Mvno_IijConnect.ChangeCouponStatus"を指定してコールする
paramsとして渡すJSONをaction:0として渡すと高速通信OFF,action:1だとONになる。



おしらせ：　https://www.dmm.com/service/-/json/=/method=AndroidApp

{
    "event": true,
    "data": {
        "version": "5",
        "current_version": "5",
        "message": "アップデート情報があります。\n\n・高速データ通信残量表示をMB(GB)に変更しました。\n\n・追加チャージボタンを誤って押さないようにデフォルト未選択に変更しました。",
        "redirect_url": https://play.google.com/store/apps/details?id=com.dmm.app.mvno"
    },
    "exectime": 0.0023,
    "memory": "884,741"
}



アプリ一覧：　http://app-api.dmm.com/applist/v1/apps

{
    "result": "OK",
    "title": "DMM Apps",
    "banner_list": [{
        "banner_id": "44",
        "image_url": "http://pics.dmm.co.jp/appapi/app_images/ba_%KEY%.jpg",
        "url": "https://play.google.com\/store\/apps\/details?id=com.dmm.make.OrderCase"
    }, {
        "banner_id": "24",
        "image_url": http://pics.dmm.co.jp/appapi/app_images/ba_%KEY%.jpg",
        "url": "https:\/\/play.google.com\/store\/apps\/details?id=jp.nikukai\u0026hl=ja"
    }],
 
    "icon_list": [{
        "icon_id": "59",
        "image_url": "http://pics.dmm.co.jp/appapi/app_images/ic_%GUID%.png",
        "name": "DMM.E",
        "description": "チケット申し込みから入場まで...",
        "price": "0",
        "badge": "2",
        "app_info": "com.dmm.app.event"
    }, {
        "icon_id": "57",
        "image_url": "http://pics.dmm.co.jp/appapi/app_images/ic_%GUID%.png",
        "name": "DMM.yell",
        "description": "有名人の投稿写真や動画の閲覧...",
        "price": "0",
        "badge": "0",
        "app_info": "com.dmm.sub.yell"
    }]
}

関連記事
同じカテゴリの記事はこちらから!! → 未分類

コメントを残す

メールアドレスが公開されることはありません。