پارٹنر کمائی API

اگر آپ اپنی ویب سائٹ یا پینل پر اپنی کمائی دیکھنا چاہتے ہیں تو earnings API کنیکٹ کریں۔ یہ وہی اعداد و شمار واپس کرتا ہے جو Millida پر آپ کے بیلنس میں نظر آتے ہیں: بیلنس، نکالنے کے لیے دستیاب رقم، اور منتخب مدت کی کمائی، سروس کے لحاظ سے الگ الگ: موڈ پیک سبسکرپشنز، ہوسٹنگ، ڈونیشنز، مارکیٹ، اور دیگر۔

API صرف پڑھنے کے لیے ہے۔ آپ اس کے ذریعے رقم نہیں نکال سکتے، پے آؤٹ کی تفصیلات نہیں بدل سکتے، اور نہ ہی کسی چیز کی ادائیگی کر سکتے ہیں۔ کلید صرف آپ کا بیلنس دیکھتی ہے؛ اس سے آپ دوسروں کا ڈیٹا نہیں دیکھ سکتے۔

کلید

کلید پارٹنر ڈیش بورڈ میں جاری کی جاتی ہے: پروفائل → آپ کے اسٹوڈیو کے نام والا سیکشن → Earnings API۔ اسے جاری کرتے وقت اس سرور کا IP ایڈریس بتائیں جہاں سے درخواستیں بھیجی جائیں گی۔ کلید کسی دوسرے ایڈریس سے کام نہیں کرتی، چاہے وہ چوری ہو گئی ہو۔

• آپ زیادہ سے زیادہ دس ایڈریس یا سب نیٹ بتا سکتے ہیں۔ سب نیٹ IPv4 کے لیے /24 سے اور IPv6 کے لیے /48 سے زیادہ وسیع نہیں ہونا چاہیے۔
• گھریلو اور لوکل ایڈریس (127.0.0.1، 10.x، 192.168.x) قبول نہیں کیے جاتے: آپ کو سرور کا پبلک ایڈریس درکار ہے۔
• کلید صرف ایک بار دکھائی جاتی ہے۔ اسے سرور پر، environment variables میں، یا کسی secrets store میں محفوظ رکھیں، اور کبھی براؤزر کے سامنے ظاہر نہ کریں۔
• آپ کے پاس زیادہ سے زیادہ پانچ فعال کلیدیں ہو سکتی ہیں۔ اگر کلید گم ہو جائے یا آپ سرور بدلیں تو پرانی کلید منسوخ کریں اور نئی جاری کریں۔ منسوخ شدہ کلید فوراً کام کرنا بند کر دیتی ہے۔

تمام endpoints https://api.millida.net/v2 کے نسبت سے ہیں۔ کلید header میں بھیجی جاتی ہے:

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 کو فی منٹ ایک بار سے زیادہ poll کرنے کا کوئی فائدہ نہیں۔ بہتر ہے کہ جواب کو اپنے سرور پر cache کر لیں۔

مثال

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"