合作伙伴收益 API

如果您想在自己的网站或面板中查看收益，请接入收益 API。它返回的数据与 Millida 钱包中的数字一致：余额、可提现金额，以及所选周期内按服务划分的收益明细：整合包订阅、托管、打赏、市场和其他。

该 API 为只读。您无法通过它提现、修改收款信息或支付任何费用。密钥只能看到您自己的钱包，无法用它访问他人的数据。

密钥

密钥在合作伙伴面板中签发：个人资料 → 以您的工作室命名的分区 → 收益 API。签发时请指定发送请求的服务器 IP 地址。密钥无法从其他任何地址使用，即使被盗也一样。

• 最多可以指定十个地址或子网。IPv4 的子网不得宽于 /24， IPv6 不得宽于 /48。
• 家庭地址和本地地址（127.0.0.1、10.x、192.168.x）不予 接受：需要服务器的公网地址。
• 密钥只显示一次。请将其保存在服务器上、环境变量中 或密钥管理服务里，切勿暴露给浏览器。
• 最多可以有五个有效密钥。如果密钥丢失或更换服务器， 请吊销旧密钥并签发新密钥。已吊销的密钥会立即失效。

所有端点均相对于 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 订阅在玩您的整合包，以及周期内订阅发生了什么变化。订阅者按有效访问权限统计，而不是按付款统计：只要一个人能够启动整合包就算作订阅者，包括付款日后为再次扣款提供的三天宽限期。通过您网站密钥的访问、团队访问和一次性购买不计入订阅。

该 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 列出您的所有整合包，包括没有订阅者的整合包。

bundle 统计的是人数，而 packs 统计的是单个整合包的订阅数。 如果订阅被取消，它会在取消当天出现在 canceled 中，并在 已付期限结束时出现在 expired 中。

错误

限制

单个密钥每分钟最多可发送 30 个请求。数字会随 付款而变化，因此每分钟轮询 API 超过一次没有意义。最好在 您的服务器上缓存响应。

示例

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"