భాగస్వామ్య ఆదాయ API

మీరు మీ స్వంత వెబ్‌సైట్‌లో లేదా ప్యానెల్‌లో మీ ఆదాయాన్ని చూడాలనుకుంటే, ఆదాయ APIని కనెక్ట్ చేయండి. ఇది Millidaలోని మీ వాలెట్‌లో చూపించే అదే గణాంకాలను అందిస్తుంది: బ్యాలెన్స్, విత్‌డ్రా చేయడానికి అందుబాటులో ఉన్న మొత్తం, మరియు ఎంచుకున్న కాలానికి సేవల వారీగా విభజించిన ఆదాయం: మోడ్‌ప్యాక్ సబ్‌స్క్రిప్షన్‌లు, హోస్టింగ్, డొనేషన్‌లు, మార్కెట్, మరియు ఇతరులు.

API రీడ్-ఓన్లీ. దీని ద్వారా మీరు డబ్బు విత్‌డ్రా చేయలేరు, పేఅవుట్ వివరాలను మార్చలేరు, లేదా ఏదైనా చెల్లించలేరు. కీ మీ వాలెట్‌ను మాత్రమే చూస్తుంది; దీనితో మీరు ఇతరుల డేటాను యాక్సెస్ చేయలేరు.

కీ

కీని పార్టనర్ డాష్‌బోర్డ్‌లో జారీ చేస్తారు: Profile → మీ స్టూడియో పేరుతో ఉన్న సెక్షన్ → Earnings 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"