کیٹلاگ مصنف API

آپ اپنے مواد کے ساتھ سائٹ پر جو کچھ بھی کرتے ہیں، وہ سب اپنی اسکرپٹ یا بلڈ پائپ لائن سے کر سکتے ہیں: ڈرافٹ بنانا، نئی ورژن اپ لوڈ کرنا، صفحہ میں ترمیم کرنا، قیمت تبدیل کرنا اور سیلز دیکھنا۔ اس کے لیے آپ کو ایک مصنف کی کلید درکار ہے — ایک اسٹرنگ جیسے mca_live_…۔

کلید صرف آپ کے مواد کے ساتھ کام کرتی ہے: وہی مواد جس کے مصنف آپ ہیں۔ آپ اس سے کسی اور کا کام نہیں چھو سکتے، چاہے آپ کو اس کا ایڈریس معلوم ہو۔

کلید

کلید آپ کے پروفائل میں، مصنف سیکشن میں جاری کی جاتی ہے۔ کلید کو نام دیں اور اسکوپس منتخب کریں؛ کلید ایک بار دکھائی جاتی ہے — اسے اپنی پائپ لائن کے سیکرٹس میں محفوظ کر لیں۔ اگر گم ہو جائے تو اسے منسوخ کریں اور نئی جاری کریں۔ آپ کے پاس زیادہ سے زیادہ دس فعال کلیدیں ہو سکتی ہیں۔ پاس ورڈ یا ای میل تبدیل کرنے سے اکاؤنٹ کی تمام کلیدیں منسوخ ہو جاتی ہیں — اس کے بعد نئی جاری کریں۔

پائپ لائن کو صرف وہی دیں جس کی اسے ضرورت ہے: بلڈ کلید عام طور پر versions:write اور stats:read کے ساتھ رکھی جاتی ہے۔

تمام اینڈ پوائنٹس https://api.millida.net/v2 کے تحت ہیں؛ کلید ہیڈر میں جاتی ہے:

Authorization: Bearer mca_live_…

میرے مواد

GET /catalog/author-api/items

[
  {
    "slug": "my-pack",
    "type": "MODPACK",
    "title": "My modpack",
    "status": "PUBLISHED",
    "moderationStatus": "PUBLISHED",
    "pricing": "ONE_TIME",
    "priceKopecks": 49900,
    "versionsCount": 12,
    "downloads": 5310,
    "publicUrl": "/modpacks/my-pack"
  }
]

نیا مواد

POST /catalog/author-api/items
{ "type": "MOD", "title": "My mod", "summary": "Briefly about the mod" }

مواد ایک ڈرافٹ کے طور پر ظاہر ہوتا ہے۔ ایڈریس (slug) نام سے لیا جاتا ہے؛ پہلے سے موجود ایڈریس 409 واپس کرتا ہے اور ایک خالی ایڈریس کی تجویز دیتا ہے۔ تخلیق کے وقت قیمت (pricing, priceKopecks) صرف اسی کلید کے ساتھ دی جا سکتی ہے جس میں pricing:write اسکوپ ہو؛ ورنہ جواب 403 MISSING_SCOPE ہوتا ہے۔

نئی ورژن

1. اپ لوڈ URL:

POST /catalog/author-api/items/my-pack/upload-url
{ "version": "1.4.0", "fileName": "my-pack-1.4.0.zip", "size": 734003200 }

{ "uploadUrl": "https://…", "storageKey": "catalog/packs/my-pack/…", "expiresIn": 3600 }

2. فائل اپ لوڈ کریں uploadUrl پر PUT ریکوئسٹ کے ذریعے — براہ راست اسٹوریج پر، ہمارے بغیر درمیان میں:

curl -X PUT --upload-file my-pack-1.4.0.zip "$UPLOAD_URL"

3. ورژن رجسٹر کریں:

POST /catalog/author-api/items/my-pack/versions
{
  "version": "1.4.0",
  "storageKey": "catalog/packs/my-pack/…",
  "gameVersions": ["1.20.1"],
  "loaders": ["fabric"],
  "loaderVersion": "0.16.0",
  "changelog": "New quests"
}

ورژن خودکار جائزے میں جاتی ہے اور اس کے بعد کھلاڑیوں کو نظر آتی ہے۔ ہر اپ لوڈ ایک نئی فائل ہے: آپ پہلے سے شائع شدہ ورژن کو اوور رائٹ نہیں کر سکتے۔

جائزے کے لیے جمع کرانا

نیا مواد ماڈریٹر کے بعد کیٹلاگ میں داخل ہوتا ہے۔ جب اس کی کم از کم ایک ورژن ہو، تو تصدیق کریں کہ کام آپ کا ہے اور لائسنس آپ نے منتخب کیا ہے۔ یہ ایک الگ ریکوئسٹ ہے: جائزے کے لیے جمع کرانا یہ کام آپ کے لیے نہیں کرتا۔

POST /catalog/author-api/items/my-pack/authorship

{ "ok": true }

پھر مواد جمع کرائیں:

POST /catalog/author-api/items/my-pack/submit

{ "ok": true, "status": "PENDING" }

تصدیق کے بغیر جواب 400 ہوتا ہے ”تصدیق کریں کہ موڈ پیک آپ کا ہے اور لائسنس آپ نے منتخب کیا ہے“؛ ورژن کے بغیر 400 ”پہلے موڈ پیک فائل اپ لوڈ کریں“۔

صفحہ

PUT /catalog/author-api/items/my-pack/page
{ "title": "My modpack", "summary": "…", "descriptionMd": "## What's inside\n…" }

یہ ایک ڈرافٹ ہے: کھلاڑی پچھلا صفحہ دیکھتے رہتے ہیں جب تک نیا صفحہ جائزہ پاس نہ کر لے۔ تفصیل میں تصاویر صرف ہمارے پاس اپ لوڈ ہونی چاہئیں؛ لنکس صرف Millida کے صفحات کی طرف اشارہ کریں۔ پہلے آئیکن (iconUrl)، اسکرین شاٹس (gallery) اور تفصیل کی تصاویر اپ لوڈ کریں:

curl -H "Authorization: Bearer $MCA_KEY" -F "file=@icon.png" https://api.millida.net/v2/catalog/author-api/images

{ "url": "https://…/uploads/…/icon.png" }

PNG، JPG، WebP اور AVIF 15 MB تک معاون ہیں؛ GIF نہیں۔ اپ لوڈ کے لیے page:write اسکوپ درکار ہے؛ جواب میں ایک ایڈریس ہوتا ہے جسے آپ صفحہ میں رکھ سکتے ہیں۔ جائزے کے لیے جمع کرائیں:

POST /catalog/author-api/items/my-pack/page/submit

قیمت

PUT /catalog/author-api/items/my-pack/pricing
{ "pricing": "ONE_TIME", "priceKopecks": 49900 }

• رقوم کوپیکس میں ہیں۔ ادائیگی والے مواد کی کم از کم قیمت 300 ₽ (30000) ہے، اسکن اور کیپ کے لیے — 50 ₽ (5000)؛ زیادہ سے زیادہ 100,000 ₽ (10000000) ہے۔
• پلیٹ فارم ہر سیل سے 30% لیتا ہے؛ باقی آپ کے Millida والٹ میں جاتا ہے۔
• سیل کی رقم Millida کے اندر فوراً خرچ کی جا سکتی ہے، لیکن نکاسی خریداری کے 7 دن بعد دستیاب ہوتی ہے۔
• ادائیگی والے مواد کی فائلیں صرف رسائی رکھنے والے ڈاؤن لوڈ کر سکتے ہیں۔ بطور مصنف، آپ کو ہمیشہ رسائی حاصل ہے۔

اعداد و شمار

GET /catalog/author-api/items/my-pack/stats

{
  "versions": [{ "version": "1.4.0", "downloads": 312, "reviewStatus": "APPROVED" }],
  "players": { "players": 1204, "playersRecent": 380, "days": [{ "day": "2026-09-24", "players": 41 }] },
  "sales": {
    "totalKopecks": 998000,
    "netKopecks": 698600,
    "count": 20,
    "refundedCount": 0,
    "holdDays": 7,
    "last30d": [{ "day": "2026-09-24", "count": 3, "netKopecks": 104790 }]
  }
}

تمام مواد کی سیلز ایک ساتھ:

GET /catalog/author-api/sales

خرابیاں

ایرر جواب میں ہمیشہ message ہوتا ہے — آپ اسے ویسے ہی کسی شخص کو دکھا سکتے ہیں — اور اکثر code بھی — جو اسکرپٹ میں برانچنگ کے لیے آسان ہے۔

حدود

• فی کلید 120 ریکوئسٹس فی منٹ۔
• نئے مواد — 10 فی گھنٹہ، اپ لوڈ URL اور ورژنز — 30 فی گھنٹہ ہر ایک، صفحہ میں ترامیم — 120 فی گھنٹہ، تصاویر — 60 فی گھنٹہ، قیمت میں تبدیلیاں — 60 فی گھنٹہ۔