mineoアプリ　API仕様

Last updated at 2025-11-30Posted at 2024-07-25

はじめに

（2025/12/01）より新しい情報はブログに書いてます！

mineoのパケットギフトという機能で2回線（+家族の1回線）のパケットの無限繰り越しを毎月せっせと行っています。
いろいろ自動化していきたいと思う今日この頃、ふとパケットギフトも自動化できないかと考え、mineoアプリを活用してパケットギフトの通信方法を調べてみることにしました。

各APIの仕様

以下で紹介するAPIはいずれも非公開APIと考えられます。
研究・開発目的での利用に留めるほか、過度なアクセスはお控えください。

全体

紹介するAPIは特に記述が無い限り、全て以下のパラメータを必要とします。

パラメータ	値
appId	（任意の文字列）
appVersion	（任意の文字列）
Authorizatrion	Bearer
aid	（任意の文字列）

appId、appVersionは何を設定しても動作に問題ありません。

通常、appIdはmineoApp、
appVersionは2.18.00が設定されています（2024年7月現在）。

Authorizationは、mitmproxyなどのツールで確認してください。
Authorizationは、24時間の有効期限が設定されています。
不正なAuthorizationを入力すると次のエラーが返されます。

Response_error

{
    "statusCode": 401,
    "message": "Invalid JWT."
}

aidは恐らくmineo側から付与されたIDFA/AAID（広告識別子）です。
必須項目ですが、こちらも適当な文字列を入力しても通るようです。

また、custIdをform-urlencodedで指定する必要があります。
custIdは回線毎に固有番号を持っています。

URLEncoded Form

custId: ABC12DE345

回線関係

Get Telnum List

eoIDで契約している回線の一覧を取得します。
また、他のAPIで必要となるcustIdもここで取得できます。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_telnum_list

以降のAPIにも当てはまることですが、URLにはGETと書いておきながら、
実際のメソッドはPOSTであることに注意してください。

このAPIはcustIdを必要としません。

Response_ok

{
    "messages": [
        null
    ],
    "resultCode": "00",
    "telNumList": [
        {
            "custId": "ABC12DE345",
            "lineName": "iPhone",          // 回線名称
            "telNum": "080XXXXXXXX"        // 電話番号
        },
        {
            "custId": "ABC12DE345",
            "lineName": "iPhone_sub",
            "telNum": "080XXXXXXXX"
        },
        {
            "custId": "ABC12DE345",
            "lineName": "iPad",
            "telNum": "090XXXXXXXX"
        }
    ]
}

パラメータが不足している場合、エラーが返されます。

Response_error

{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "telNumList": null
}

Get Line Name

契約回線に設定した回線名称を取得します。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_line_name

Response_ok

{
    "lineName": "iPhone",  // 回線名称
    "messages": [
        null
    ],
    "resultCode": "00"
}

Response_error

// パラメータ不足
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "lineName": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "lineName": null
}

パケット関係

Get Capacity

契約回線のパケット使用量、残量を確認するために使用されます。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_capacity

Response_ok

{
    "lowSpeedDisp": null,  // mineoスイッチON時 -> "通信速度最大200kbps適用中"
    "messages": [
        null
    ],
    "mySokuFlg": "0",                       // 0 -> マイそくOFF, 1 -> マイそくON
    "packetInfo": {
        "baseCapacity": 5120,               // 基本データ容量
        "baseRemainingCapacity": 5120,      // 残り基本データ容量
        "chargeCapacity": 0,                // チャージ容量
        "chargeRemainingCapacity": 0,       // 残りチャージ容量
        "forwardCapacity": 67254,           // 前月繰り越し容量
        "forwardRemainingCapacity": 33563,  // 残り前月繰り越し容量
        "giftCapacity": 0,                  // ギフト容量
        "giftRemainingCapacity": 0          // 残りギフト容量
    },
    "resultCode": "00",
    "serviceName": "Dプラン デュアルタイプ (5GB)",
    "speedFlg": "1",                        // 0 -> mineoスイッチON, 1 -> mineoスイッチOFF
    "tushinSettingStatusCode": "00"         // 00 -> mineoスイッチOFF, 01 -> mineoスイッチON
}

Response_error

// パラメータ不足
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "packetInfo": null,
    "speedFlg": null,
    "tushinSettingStatusCode": null,
    "mySokuFlg": null,
    "serviceName": null,
    "lowSpeedDisp": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "packetInfo": null,
    "speedFlg": null,
    "tushinSettingStatusCode": null,
    "mySokuFlg": null,
    "serviceName": null,
    "lowSpeedDisp": null
}

Get Capacity For Gift

パケットギフトのギフト可能容量を確認できます。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_capacity_for_gift

Response_ok

{
    "capacityForGift": 40918,
    "messages": [
        null
    ],
    "resultCode": "00"
}

Response_error

// パラメータ不足
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "capacityForGift": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "capacityForGift": null
}

Change Gift

発行済みパケットギフトを受け取ります。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/change_gift

受け取りたいパケットギフトのコードは、form-urlencodedで指定できます。

URLEncoded Form

giftCode: ABCD1234

Response_ok

{
    "resultCode": "00",
    "messages": [
      null
    ],
    "giftCapacity": 10
}

Response_error

// パラメータ不足
{
    "resultCode": "0098",
    "messages": [
      "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "giftCapacity": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "giftCapacity": null
}

// ギフト発行した回線と同一回線でパケットギフトを受け取ろうとした
{
    "resultCode": "0056",
    "messages": [
      "発行元と受取先が同一のため、受け取りできません。"
    ],
    "giftCapacity": null
}

// 存在しないパケットギフトを受け取ろうとした
{
    "resultCode": "0051",
    "messages": [
      "このギフトコードは存在しません。"
    ],
    "giftCapacity": null
}

Issue Gift

パケットギフトを発行します。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/issue_gift

ギフト容量は、form-urlencodedで指定できます。
giftCapacityはmineoアプリと同様、10以上9999以下で指定する必要があります。

URLEncoded Form

giftCapacity: 1000

Response_ok

{
    "expireDate": "20240727",      // 有効期限
    "giftCapacity": 1000,          // ギフト容量
    "giftCode": "ABCD1234",        // ギフトコード
    "messages": [
        null
    ],
    "resultCode": "00"
}

Response_error

// パラメータ不足、または範囲外のギフト容量を指定した
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "giftCode": null,
    "giftCapacity": null,
    "expireDate": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "giftCode": null,
    "giftCapacity": null,
    "expireDate": null
}

//

ゆずるね。関係

Declare Devolve

ゆずるね。宣言を行います。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/declare_devolve

Response_ok

{
    "resultCode": "00",
    "messages": [
        null
    ]
}

// 既に宣言済み
{
    "resultCode": "05",
    "messages": [
        null
    ]
}

Response_error

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ]
}

// 宣言受付時間外（11:30～12:59）
{
    "resultCode": "0061",
    "messages": [
        "現在、ゆずるね。宣言いただけません。次回分のゆずるね。宣言は１３時以降に可能です。"
    ]
}

Get Devolve Declare Stat

ゆずるね。の宣言状況を取得します。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_devolve_declare_stat

Reponse_ok

{
    "resultCode": "00",
    "messages": [
        null
    ],
    "devolveDeclareStat": "1",          // 宣言状態（0 -> 宣言待ち, 1 -> 宣言済み）
    "devolveDeclareAcceptability": "1"  // 宣言結果（0 -> 未宣言, 1 -> 宣言済み, 2 -> 宣言受付時間外）

Response_Error

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "devolveDeclareStat": null,
    "devolveDeclareAcceptability": null
}

Get Devolve Declare Hist Thismonth

ゆずるね。の達成状況・特典状況を取得します。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_devolve_declare_hist_thismonth

Reponse_ok

{
    "resultCode": "00",
    "messages": [
        null
    ],
    "nengetsu": "202511",
    "successCntAmount": 0,
    "devolveDeclareHistList": null,  // 達成状況
    "devolveTokutenMstList": [       // 特典状況   
        {
            "devolveTokutenName": "100MB",
            "requiredStamps": 5
        },
        {
            "devolveTokutenName": "ゆずるね。深夜フリー特典",
            "requiredStamps": 10
        },
        {
            "devolveTokutenName": "200MB",
            "requiredStamps": 15
        },
        {
            "devolveTokutenName": "契約容量パケット",
            "requiredStamps": 20
        }
    ]
}

Reponse_error

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "nengetsu": null,
    "successCntAmount": null,
    "devolveDeclareHistList": null,
    "devolveTokutenMstList": null
}

その他機能

Change Speed

mineoスイッチのON/OFFを切り替えます。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/change_speed

form-urlencodedでspeedFlgを0または1で指定することで、変更できます。

URLEncoded Form

// mineoスイッチをONに変更
speedFlg: 0

// mineoスイッチをOFFに変更
speedFlg: 1

Response_ok

{
    "messages": [
        null
    ],
    "resultCode": "00"
}

Response_error

// パラメータ不足、またはspeedFlgを範囲外に指定した
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ]
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ]
}

// mineoスイッチのクールダウン（1分間）中に実行した
{
    "resultCode": "0025",
    "messages": [
        "エラーが発生しております。\n時間をおいてから再度お試しください。"
    ]
}

Get Traffic History

過去3ヶ月分のデータ通信量、パケットギフト、マイネ王からのパケットの出入りを確認できます。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/get_traffic_history

Response_ok

{
    "messages": [
        null
    ],
    "monthlyTrafficHistoryList": [
        {
            "averageInfo": {                      // 一日あたりの平均通信量
                "dataTraffic": 242,               // データ通信量（合計）
                "dataTrafficAdCountFree": 0,      // データ通信量（広告フリー）
                "dataTrafficHighSpeed": 242,      // データ通信量（高速）
                "dataTrafficLowSpeed": 0,         // データ通信量（低速・mineoスイッチON）
                "decreaseFreeTank": 0,            // フリータンクに入れた通信量・贈ったチップなど
                "decreasePacketGift": 955,        // 発行したパケットギフト
                "increaseFreeTank": 0,            // フリータンクから引き出した通信量・受け取ったチップなど
                "increasePacketGift": 1458,       // 受け取ったパケットギフト
                "targetDay": null
            },
            "dailyTrafficHistoryList": [          // 一日ごとのデータ通信量を集計
                {
                    "dataTraffic": 143,
                    "dataTrafficAdCountFree": 0,
                    "dataTrafficHighSpeed": 143,
                    "dataTrafficLowSpeed": 0,
                    "decreaseFreeTank": 0,
                    "decreasePacketGift": 0,
                    "increaseFreeTank": 0,
                    "increasePacketGift": 0,
                    "targetDay": "1"               // 日にち（ここでは5月1日を表す）
                },
                {
                    "dataTraffic": 4,
                    "dataTrafficAdCountFree": 0,
                    "dataTrafficHighSpeed": 4,
                    "dataTrafficLowSpeed": 0,
                    "decreaseFreeTank": 0,
                    "decreasePacketGift": 0,
                    "increaseFreeTank": 0,
                    "increasePacketGift": 0,
                    "targetDay": "2"
                },
                {
                    "dataTraffic": 1,
                    "dataTrafficAdCountFree": 0,
                    "dataTrafficHighSpeed": 1,
                    "dataTrafficLowSpeed": 0,
                    "decreaseFreeTank": 0,
                    "decreasePacketGift": 0,
                    "increaseFreeTank": 0,
                    "increasePacketGift": 0,
                    "targetDay": "3"
                },
                // 以下、月最終日（targetDay->31）まで省略
            ],
            "sumInfo": {                             // データ通信量の月合計
                "dataTraffic": 7501,
                "dataTrafficAdCountFree": 0,
                "dataTrafficHighSpeed": 7501,
                "dataTrafficLowSpeed": 0,
                "decreaseFreeTank": 0,
                "decreasePacketGift": 29598,
                "increaseFreeTank": 0,
                "increasePacketGift": 45196,
                "targetDay": null
            },
            "targetMonth": "5"                      // 集計月
        },
        {
            "averageInfo": {                        // 6月分
                "dataTraffic": 277,
                "dataTrafficAdCountFree": 0,
                "dataTrafficHighSpeed": 277,
                "dataTrafficLowSpeed": 0,
                "decreaseFreeTank": 0,
                "decreasePacketGift": 2309,
                "increaseFreeTank": 0,
                "increasePacketGift": 2242,
                "targetDay": null
            },
            
            // 省略
            
            "sumInfo": {
                "dataTraffic": 3696,
                "dataTrafficAdCountFree": 0,
                "dataTrafficHighSpeed": 3696,
                "dataTrafficLowSpeed": 0,
                "decreaseFreeTank": 0,
                "decreasePacketGift": 0,
                "increaseFreeTank": 0,
                "increasePacketGift": 0,
                "targetDay": null
            },
            "targetMonth": "7"
        }
    ],
    "resultCode": "00"
}

Response_error

// パラメータ不足
{
    "resultCode": "0098",
    "messages": [
      "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "monthlyTrafficHistoryList": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "monthlyTrafficHistoryList": null
}

Login Stamp

mineoアプリを起動するともらえるログインスタンプを確認、獲得します。

パラメータ	値
Method	POST
URL	https://api.eonet.jp/mineo/v1/login_stamp

form-urlencodedでupdateModeを0か1の値にし、ログインスタンプを獲得するか指定します。
既にログイン済みでもエラーは出ないため、基本的には1を指定しておけば問題ないでしょう。

URLEncoded Form

// ログインスタンプを獲得しない
updateMode:0

// 今日未ログインだった場合、ログインスタンプを獲得する
updateMode: 1

Reponse_ok

{
    "resultCode": "00",
    "messages": [
        null
    ],
    "stampCnt": 155,      // 累計スタンプカウント
    "updateFlg": "0",     // 0 -> 何もしない、 1 -> ログインスタンプを獲得した 
    "tokutenList": [
        {
            "id": "LS00000001",
            "name": "100MB",
            "requiredStamps": 20,   // stampCnt % requiredStamps -> 残り必要スタンプ数
            "getFlg": "0"           // 0 -> 何もしない、　1 -> 特典を獲得した
        },
        {
            "id": "LS00000002",
            "name": "王国コイン",
            "requiredStamps": 100,
            "getFlg": "0"
        }
    ]
}

Response_error

// パラメータ不足、またはupdateModeを範囲外に指定した
{
    "resultCode": "0098",
    "messages": [
        "システムエラー。\n時間をおいてから再度お試しください。"
    ],
    "stampCnt": null,
    "updateFlg": null,
    "tokutenList": null
}

// 存在しないcustId
{
    "resultCode": "0022",
    "messages": [
        "認証エラー。\nログアウト後、再ログインしてください。"
    ],
    "stampCnt": null,
    "updateFlg": null,
    "tokutenList": null
}

おまけ

Authorizationについて

今まで紹介した各APIはAuthorizationが必要で、しかも24時間経過で有効期限が切れるという仕様があります。
しかし幸いなことにトークンを発行するためのAPIがあり、refresh_tokenさえ入手できれば、あとは一日おきに実行するだけでトークンを自動更新できるようになります。

パラメータ	値
Method	POST
URL	https://login.eonet.jp/oidc/v1/token

form-urlencodedで次のように指定します。

URLEncoded Form

grant_type: refresh_token     // 固定値
refresh_token: TOKEN
client_id: 100064798          // 固定値

refresh_tokenはmitmproxyなどのツールを実行した状態で、mineoアプリをログアウト・ログインし、上記URLのResponse Bodyを確認すると入手できます。

grant_typeをauthorization_codeに指定し、code、code_verfier、redirect_uriを指定することで新規発行が可能な様です。
しかしcodeとcode_verfierの入手方法が複雑であるため、今回は扱いが容易なrefresh_tokenのみを取り扱います。

Response_ok

{
    "access_token": "xxE05YhIxMdoJmY......",
    "expires_in": "86400",
    "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjNIOURJcUNXZ1R5dzdOdW1ZV1daM3cifQ......",
    "refresh_token": "VEweVyQQCzmTwPmBXd......",
    "token_type": "Bearer"
}

Response Bodyにあるid_tokenは、今まで紹介したAPIのAuthorizationパラメータで使用することができます（有効期限24時間）。

なお、refresh_tokenはワンタイムトークンであり、同じトークンで再度APIにアクセスしようとするとエラーが返されます。

Response_error

{
    "error" : "invalid_token",
    "error_description" : "refresh token is not exists"
}

もしrefresh_tokenを控えるのを忘れてしまった、期限が切れてしまった場合は、mitmproxyなどのツールを使って上記手順をやり直しましょう。

おわりに

紹介したもの以外にもまだいくつかAPIはあるのですが、いまいち用途の分からないものもあったので割愛しています。
あとマイネ王のフリータンク関係も書くつもりでしたが、長すぎたので別記事に分割しようと思います。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up

mineoアプリ API仕様

はじめに

各APIの仕様

全体

回線関係

Get Telnum List

Get Line Name

パケット関係

Get Capacity

Get Capacity For Gift

Change Gift

Issue Gift

ゆずるね。関係

Declare Devolve

Get Devolve Declare Stat

Get Devolve Declare Hist Thismonth

その他機能

Change Speed

Get Traffic History

Login Stamp

おまけ

Authorizationについて

おわりに

mineoアプリ　API仕様