ፋይል

የእርስዎን አጋር መዝገብ, referrals, ኮሚሽኖች እና ክፍያዎችን ማንበብ, የእርስዎን ክፍያ ምርጫዎች መቀየር እና ክፍያ መጠየቅ. ሁሉም መጨረሻ ነጥብ ላይ የሚሠራ አጋር ሒሳብ የ API ቶኬን ያስተዳድራል.

የመጨረሻ ነጥቦች 7 endpoints

የመሠረት መንገድ /api/v1/affiliates

መጨረሻ

በሂሳብ ውስጥ ቶኬን ይፍጠሩ፣ ከዚያም ዳይቨርሰርስ፣ እና በታች ያሉት መጨረሻዎች የሚያስፈልጉትን ስፋቶች ይስጡት። ያልተያያዘ ሂሳብ ከሁሉም መጨረሻዎች 404 ይቀበላል ምዝገባን ጨምሮ።

መጨረሻ	ርዝመት፦	መግለጫ የለም
`GET /affiliates/me/`	`affiliates:read`	የእርስዎ የተሳተፉ መዝገብ, ብልጫ እና መላክ አገናኝ
`GET /affiliates/referrals/`	`affiliates:read`	የይለፍ ቃል
`GET /affiliates/commissions/`	`affiliates:read`	የእርስዎን መላክ
`GET /affiliates/payouts/`	`affiliates:read`	የቀረበው እና የተከፈለው
`PATCH /affiliates/settings/`	`affiliates:update`	የክፍያ ዘዴን፣ የPayPal ኢሜይል፣ የStripe ሒሳብ ወይም የጥቂት የክፍያ መጠንን ይለውጡ `min_payout_amount ≥ 10.00`
`POST /affiliates/request-payout/`	`affiliates:create`	የባንክ ሂሳብዎን በትንሹ ከፍታ ላይ ሲደርስ የክፍያ ጥያቄ ያቀርቡ። በአንድ ጊዜ አንድ ብቻ የሚጠበቀው ክፍያ ነው።
`POST /affiliates/signup/`	`affiliates:create`	በጋራ ፕሮግራም ይመዝገቡ. payment_method (PayPal ወይም Stripe) PayPal_email ወይም Stripe_account_id ጋር መላክ.

የቀረበው, ኮሚሽኖች እና የክፍያ ዝርዝሮች ገጽታ ናቸው: መልስ ሁሉ ቁጥር, ቀጣይ, በፊት እና ውጤቶች አለው. ገጽ በመካከላቸው ለመንቀሳቀስ እና ገጽ_ስፋት ገጽ በእያንዳንዱ ውስጥ ምን ያህል ነገሮችን ይይዛል ለመቀየር ይጠቀሙ. የገንዘብ ዋጋዎች እንደ ዐስርኛ ሐረግ ተመልሰዋል. page_size: 25 (default), 100 (max)

አግኝ /api/v1/affiliates/me/

የእርስዎን የቅርብ ጊዜ መዝገብ ቤት ያግኙ

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/affiliates/me/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
base = "https://admin.vps.org/api/v1/affiliates"

me = requests.get(f"{base}/me/", headers=headers).json()
print(me["balance"], me["total_earned"])

# Walk every page of commissions
url = f"{base}/commissions/?page_size=100"
while url:
    page = requests.get(url, headers=headers).json()
    for c in page["results"]:
        print(c["created_at"], c["amount"], c["status"])
    url = page["next"]

const res = await fetch('https://admin.vps.org/api/v1/affiliates/me/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});
const me = await res.json();
console.log(me.balance, me.referral_url);

የምሳሌ ምላሽ

{
  "uuid": "9f2c4e7a1b3d4c5e8f6a7b8c9d0e1f2a",
  "user_email": "you@example.com",
  "referral_code": "AB12CD34",
  "referral_url": "https://vps.org/?ref=AB12CD34",
  "status": "active",
  "commission_rate": "20.00",
  "cookie_days": 90,
  "payout_method": "paypal",
  "paypal_email": "you@example.com",
  "stripe_account_id": null,
  "min_payout_amount": "10.00",
  "balance": "42.50",
  "total_earned": "142.50",
  "total_paid": "100.00",
  "created_at": "2026-09-01T12:00:00Z"
}

የምላሽ መስኮች

ፋይል	አይነት	መግለጫ የለም
`status`	string	የተጠበቀ, አክቲቭ, የተቆረጠ ወይም የተቋረጠ. አክቲቭ አጋሮች ብቻ ክፍያዎችን ሊጠይቁ ይችላሉ.
`commission_rate`	decimal string	ኮሚሽን በፐርሰንት, አይደለም ክፍል `20.00 = 20%`
`cookie_days`	integer	በድረ ገጹ ላይ በመጫን ላይ የተመሠረተ
`balance`	decimal string	የተገኘና አሁንም ያልተሸጠ
`total_earned` / `total_paid`	decimal string	የሕይወት ጊዜ ኮሚሽን የተገኘ እና የሕይወት ጊዜ መጠን ተከፍሏል

የቀረበው

የመጨረሻው ውጤት

መጨረሻ	ፋይል
`/affiliates/referrals/`	`uuid, referred_email, status, created_at`
`/affiliates/commissions/`	`uuid, referred_email, amount, rate, original_amount, status, created_at`
`/affiliates/payouts/`	`uuid, amount, method, status, created_at, processed_at, error_message`

የቀረበው ሁኔታ በዝግጅት ላይ ነው፣ አክቲቭ ወይም ተወስዷል. የኮሚሽን ሁኔታ በዝግጅት ላይ ነው፣ ተፈቅዷል፣ ተከፍሏል ወይም ተወስዷል. የክፍያ ሁኔታ በዝግጅት ላይ ነው፣ በሂደት ላይ ነው፣ ተሟልቷል ወይም ተሳካ

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3b1e9c0d2a4f4e6b8c7d5e4f3a2b1c0d",
      "referred_email": "customer@example.com",
      "amount": "2.00",
      "rate": "20.00",
      "original_amount": "10.00",
      "status": "approved",
      "created_at": "2026-09-20T08:15:00Z"
    }
  ]
}

የምላሽ ሁኔታ ኮዶች

200	ውጤት
403	የጠፋ ወይም ያልሆነ API Token ወይም Token የተጠየቀውን ፈቃድ የሌለው ነው
404	ይህ ሒሳብ አሁንም አባል አይደለም

የOpenAPI ዝርዝር

የመጨረሻው ነጥብ ሁሉ የኤሌክትሮኒክ መጻፊያ ልዩነት, እነዚህን ጨምሮ, በታች ነው, እና በ API መመሪያ ገጽ ላይ ተለዋዋጭ መጎብኘት ይችላሉ.

https://admin.vps.org/api/v1/schema/

የሂሳብ ምዝገባ 1000 / hour

VPS.org API

ፋይል