Action API

Sehemu Zilizomalizika na Kuchorwa

Andika alama katika akaunti yako, kisha Huzari, na uitoe kwenye alama zilizo chini. Akaunti hilo halionyeshi watu 404 kutoka kila ncha isipokuwa ishara.

keyboard label	Aina ya "Cope "	Maelezo
`GET /affiliates/me/`	`affiliates:read`	Rekodi yako ya mambo, usawaziko na mpangilio wa maneno
`GET /affiliates/referrals/`	`affiliates:read`	Masimulizi yaliyotiwa sahihi kupitia kiungo chako
`GET /affiliates/commissions/`	`affiliates:read`	Tume zilizopata malipo ya refa
`GET /affiliates/payouts/`	`affiliates:read`	Malipo yaliyoombwa na kulipwa
`PATCH /affiliates/settings/`	`affiliates:update`	Njia ya ubadilishaji, barua pepe ya malipo, akaunti ya ukanda au kiasi kidogo cha pesa `min_payout_amount ≥ 10.00`
`POST /affiliates/request-payout/`	`affiliates:create`	Omba malipo ya kiasi mara unapofikia kiwango chako cha chini zaidi, lakini ni mmoja tu anayesubiri alipie gharama kwa wakati mmoja.
`POST /affiliates/signup/`	`affiliates:create`	Join the affiliate program. Send payout_method (paypal or stripe) with paypal_email or stripe_account_id.

Marejezo, misheni na orodha ya malipo hutiliwa maanani: kila jibu limehesabu, halafu, ya awali na matokeo. page_size: 25 (default), 100 (max)

PATA /api/v1/affiliates/me/

Andika Mambo Yanayokufaa

Ombi la Mfano

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);

Jibu la Mfano

{
  "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"
}

Sehemu za Majibu

Field	Aina	Maelezo
`status`	string	Ni watu wenye bidii tu wanaoweza kuomba malipo kwa sababu ya kuchelewa au kuachana.
`commission_rate`	decimal string	Tume ya kuwa asilimia, si sehemu `20.00 = 20%`
`cookie_days`	integer	Ni siku ngapi ambazo kidofo kwenye kiungo chako hukumbukwa
`balance`	decimal string	Wamelipwa na bado hawajalipwa
`total_earned` / `total_paid`	decimal string	Kazi ya muda wote wa maisha iliyochumwa na kiasi cha maisha kilithawabishwa

Marejezo, Tume na Malipo

Kila kitu kinachoweza kutokeza matokeo kina nyanja hizi:

keyboard label	Field
`/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`

Referral status is pending, active or cancelled. Commission status is pending, approved, paid or cancelled. Payout status is pending, processing, completed or failed.

{
  "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"
    }
  ]
}

Misimbo ya Hali ya Majibu

200	Mafanikio
403	Ishara hiyo ikikosekana au yenye kasoro, au ile ishara haina ruhusa inayohitajiwa
404	Akaunti hilo halihusiani hata kidogo na hilo

Ufafanuzi wa Sauti za Juu

Mfumo huo wa kompyuta unaoweza kusomeka kwa kila mstari, ikiwa ni pamoja na huu, upo chini, na unaweza kuupitia kwa njia ya moja kwa moja kwenye ukurasa wa marejezo wa API.

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

Mpaka wa takwimu kwa akaunti: 1000 / hour

VPS.org API