パートナー収益API

自分のウェブサイトやパネルで収益を確認したい場合は、収益 API を接続してください。Millida のウォレットと同じ数値が返されます。すなわち、残高、出金可能額、選択した期間のサービス別の収益（Modパックのサブスクリプション、ホスティング、寄付、マーケット、その他）です。

API は読み取り専用です。API を通じて出金したり、支払い先の詳細を変更したり、何かを支払ったりすることはできません。キーから見えるのは自分のウォレットだけであり、他人のデータにはアクセスできません。

キー

キーはパートナーダッシュボードで発行します: プロフィール → あなたのスタジオ名のセクション → 収益 API。発行時に、リクエストを送信するサーバーの IP アドレスを指定します。キーは他のアドレスからは動作しません。たとえ盗まれたとしても同様です。

• 指定できるアドレスまたはサブネットは最大 10 個です。サブネットは IPv4 では /24、IPv6 では /48 より広くすることはできません。
• 自宅やローカルのアドレス（127.0.0.1、10.x、192.168.x）は 受け付けられません。サーバーのパブリックアドレスが必要です。
• キーは一度だけ表示されます。サーバー上、環境変数、 またはシークレットストアに保管し、ブラウザには絶対に公開しないでください。
• 有効なキーは最大 5 個まで持つことができます。キーを紛失した場合やサーバーを変更した場合は、 古いキーを無効化して新しいキーを発行してください。無効化されたキーは即座に動作を停止します。

すべてのエンドポイントは https://api.millida.net/v2 からの相対パスです。キーはヘッダーで渡します:

Authorization: Bearer mek_live_…

サマリー

GET /earnings-api/v1/summary?from=2026-09-01T00:00:00.000Z&to=2026-09-30T23:59:59.999Z

from と to は ISO 8601 形式の期間の境界です。どちらのパラメータも 省略可能です。省略した場合、期間は全期間を対象とします。

{
  "currency": "RUB",
  "balance": {
    "balanceKopecks": 1254000,
    "availableKopecks": 1204000,
    "withdrawableKopecks": 980000,
    "heldKopecks": 50000,
    "pendingPayoutKopecks": 0,
    "tradeHoldKopecks": 0,
    "tradeHoldReadyAt": null,
    "marketHoldKopecks": 0,
    "marketWithdrawalReadyAt": null
  },
  "period": {
    "from": "2026-09-01T00:00:00.000Z",
    "to": "2026-09-30T23:59:59.999Z",
    "earnedKopecks": 3108000,
    "heldKopecks": 0,
    "spentKopecks": 0,
    "toppedUpKopecks": 0,
    "paidOutKopecks": 2000000,
    "refundKopecks": 0,
    "netKopecks": 1108000,
    "operations": 142,
    "earnedBySource": [
      { "source": "catalog", "amountKopecks": 2950000, "operations": 131 },
      { "source": "hosting", "amountKopecks": 158000, "operations": 11 }
    ],
    "truncated": false
  },
  "subscriptions": {
    "subscribers": 14,
    "bundleSubscribers": 2,
    "packSubscribers": 12
  }
}

すべての金額はコペイカ単位です: 1254000 は 12 540 ₽ を意味します。

source の値:

新しい値は今後追加される可能性があります。認識できない値はそのまま表示し、エラーとして扱わないでください。

購読者

GET /earnings-api/v1/subscriptions?from=2026-09-01T00:00:00.000Z&to=2026-09-30T23:59:59.999Z

現在、Millida のサブスクリプションであなたの Modパックをプレイしている人数と、期間中にサブスクリプションに起きたこと。購読者は支払いではなく有効なアクセスで数えられます。つまり、Modパックを起動できる限り、再試行請求のために支払日から 3 日後を含めて購読者として数えられます。あなたのウェブサイトのキーによるアクセス、チームアクセス、単発購入はサブスクリプションとして数えられません。

API は数値のみを返します。API を通じて誰が購読しているかを特定することはできません。

from と to はサマリーと同じ方法で期間を定義します。これらは period ブロックにのみ影響します。total、active、renewal、packs ブロックは常にリクエスト時点の状態を表示します。

{
  "from": "2026-09-01T00:00:00.000Z",
  "to": "2026-09-30T23:59:59.999Z",
  "generatedAt": "2026-09-28T16:30:00.000Z",
  "total": {
    "subscribers": 14,
    "bundleSubscribers": 2,
    "packSubscribers": 12
  },
  "partners": [
    {
      "partner": { "slug": "arcania-labs", "name": "Arcania Labs" },
      "active": {
        "subscribers": 14,
        "bundleSubscribers": 2,
        "packSubscribers": 12,
        "packSubscriptions": 12
      },
      "renewal": {
        "autoRenewing": { "bundle": 2, "packs": 12 },
        "canceledStillActive": { "bundle": 0, "packs": 0 }
      },
      "packs": [
        { "slug": "arcania", "title": "Arcania 1.4.3", "published": true, "activeSubscribers": 14, "viaPack": 12, "viaBundle": 2 },
        { "slug": "dread", "title": "DREAD - A Horror Survival Pack", "published": true, "activeSubscribers": 2, "viaPack": 0, "viaBundle": 2 }
      ],
      "period": {
        "newSubscriptions": { "bundle": 2, "packs": 12 },
        "canceled": { "bundle": 0, "packs": 0 },
        "expired": { "bundle": 0, "packs": 0 },
        "refunded": { "bundle": 0, "packs": 0 }
      },
      "truncated": false
    }
  ]
}

packs は購読者のいないものを含め、すべての Modパックを一覧表示します。

bundle は人数を数え、packs は個別の Modパックのサブスクリプションを数えます。 サブスクリプションがキャンセルされた場合、キャンセル日に canceled に表示され、 支払済みの期間が終了すると expired に表示されます。

エラー

制限

1 つのキーは 1 分間に最大 30 リクエストを送信できます。数値は 支払いとともに変化するため、API を 1 分に 1 回以上ポーリングしても意味がありません。 レスポンスをサーバー上でキャッシュすることをおすすめします。

例

curl -s https://api.millida.net/v2/earnings-api/v1/summary \
  -H "Authorization: Bearer $MILLIDA_EARNINGS_KEY"

curl -s https://api.millida.net/v2/earnings-api/v1/subscriptions \
  -H "Authorization: Bearer $MILLIDA_EARNINGS_KEY"