파트너 수익 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 구독으로 본인의 모드팩을 플레이하는 사람이 몇 명인지, 그리고 해당 기간 동안 구독에 어떤 일이 있었는지입니다. 구독자는 결제가 아니라 활성 접근 권한으로 집계됩니다: 재시도 청구를 위해 결제일 이후 3일을 포함하여 모드팩을 실행할 수 있는 동안은 구독자로 집계됩니다. 본인 웹사이트의 키를 통한 접근, 팀 접근, 일회성 구매는 구독으로 집계되지 않습니다.

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"