API partnerských zárobkov

Ak chceš vidieť svoje zárobky na vlastnej webovej stránke alebo v paneli, pripoj API zárobkov. Vracia rovnaké čísla ako tvoja peňaženka na Millida: zostatok, sumu dostupnú na výber a zárobky za zvolené obdobie rozčlenené podľa služby: predplatné modpackov, hosting, dary, market a ďalšie.

API je len na čítanie. Nedá sa cez neho vyberať peniaze, meniť údaje o výplatách ani za nič platiť. Kľúč vidí iba tvoju peňaženku; nedostaneš sa s ním k údajom iných ľudí.

Kľúč

Kľúč sa vydáva v partnerskom paneli: Profil → sekcia pomenovaná podľa tvojho štúdia → API zárobkov. Pri jeho vydávaní zadaj IP adresu servera, z ktorého sa budú posielať požiadavky. Kľúč nefunguje z inej adresy, ani keby bol ukradnutý.

• Môžeš zadať až desať adries alebo podsietí. Podsieť nesmie byť širšia ako /24 pre IPv4 a /48 pre IPv6.
• Domáce a lokálne adresy (127.0.0.1, 10.x, 192.168.x) sa neprijímajú: potrebuješ verejnú adresu servera.
• Kľúč sa zobrazí raz. Ulož si ho na serveri, v premenných prostredia alebo v úložisku tajomstiev a nikdy ho nevystavuj do prehliadača.
• Môžeš mať až päť aktívnych kľúčov. Ak kľúč stratíš alebo zmeníš server, odvolaj starý kľúč a vydaj nový. Odvolaný kľúč prestane fungovať okamžite.

Všetky endpointy sú relatívne k https://api.millida.net/v2. Kľúč sa posiela v hlavičke:

Authorization: Bearer mek_live_…

Súhrn

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

from a to sú hranice obdobia vo formáte ISO 8601. Oba parametre sú nepovinné: bez nich obdobie pokrýva celý čas.

{
  "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
  }
}

Všetky sumy sú v kopejkách: 1254000 znamená 12 540 ₽.

Hodnoty source:

Časom môžu pribudnúť nové hodnoty. Ak nejakú hodnotu nepoznáš, zobraz ju tak, ako je, a nepovažuj ju za chybu.

Odberatelia

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

Koľko ľudí práve teraz hrá tvoje modpacky v rámci predplatného Millida a čo sa s predplatnými stalo počas obdobia. Odberatelia sa počítajú podľa aktívneho prístupu, nie podľa platieb: človek sa počíta tak dlho, kým môže modpack spustiť, vrátane troch dní po dátume platby určených na opakovaný výber platby. Prístup cez kľúče z tvojej webovej stránky, tímový prístup a jednorazové nákupy sa ako predplatné nepočítajú.

API vracia iba čísla. Nedá sa cez neho zistiť, kto presne má predplatné.

from a to určujú obdobie rovnako ako v súhrne. Ovplyvňujú iba blok period; bloky total, active, renewal a packs vždy zobrazujú stav v čase požiadavky.

{
  "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 uvádza všetky tvoje modpacky vrátane tých bez odberateľov.

bundle počíta ľudí, kým packs počíta predplatné na jednotlivé modpacky. Ak je predplatné zrušené, objaví sa v canceled v deň zrušenia a v expired vtedy, keď sa skončí zaplatené obdobie.

Chyby

Limity

Jeden kľúč môže poslať až 30 požiadaviek za minútu. Čísla sa menia spolu s platbami, takže nemá zmysel dopytovať API častejšie ako raz za minútu. Lepšie je cachovať odpoveď na svojom serveri.

Príklad

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"