కేటలాగ్ రచయిత 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 “Confirm that the modpack is yours and the license was chosen by you”; వెర్షన్ లేకుండా, 400 “Upload the modpack file first”.

పేజీ

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.