توسعه‌دهندگان
دادهٔ aggregate وضعیت اتصال بازی‌ها در ایران — بدون PII. برای ویجت، داشبورد و ادغام فروشگاه.
احراز هویت
کلید را از پنل ادمین دریافت کنید (MVP). هدر یکی از این دو:
Authorization: Bearer pk_live_… # یا X-PingBan-Key: pk_test_…
پلن hobby: ۱۰ req/min · starter: ۶۰ · pro: ۳۰۰ · enterprise: ۱۰۰۰
Endpoints
GET /api/v1/status?game=valorant&operator=ایرانسل
scope: status — الزام به API key
GET /api/v1/gamehealth?history=30
scope: gamehealth — کلید اختیاری (با کلید سهمیه بالاتر)
GET /api/v1/trends/games?week=2026-07-07
scope: trends — Pro+ · بازی‌های داغ هفته
GET /api/v1/trends/operators?week=
scope: trends — Pro+
GET /api/v1/trends/devices?week=
scope: trends — Pro+ · FPS دستگاه‌ها
GET /api/v1/operators/score?month=2026-07
scope: trends — Operator Gaming Score ۰–۱۰۰
GET /api/v1/prime-time/valorant?operator=ایرانسل
scope: trends — اوج ساعتی probe
پورتال: /business (ورود با ایمیل تماس سازمانی)
B3 — GameLab & Forecast (جدید)
GET /api/v1/network-profile/irancell?bucket=night
scope: network-profile — Starter+ · avg/p95/jitter اپراتور
GET /api/v1/forecast?game=valorant&operator=irancell&hours=24
scope: forecast — Pro+ · پیش‌بینی lag/کیفیت
POST /api/v1/graphql
scope: trends — subset فقط trendingGames / operatorHealth / deviceTrends (+ انتخاب فیلد)
GET /api/v1/partners/domain?host=lb.partner.com
بدون کلید — دامنه اختصاصی → slug سازمان (white-label)
GET /api/v1/regions/valorant?operator=irancell
scope: trends — Region Advisor از region_ping_agg یا reports زنده (source در پاسخ)
Docker netem: GAMELAB_API_KEY=… docker run --cap-add=NET_ADMIN gamelab --operator irancell · پورتال: /business/gamelab · عمده · ISP royalty
Partner APIs (pro+ · scope partner)
POST /api/b2b/device-activation
PingPass — IMEI/سریال → اشتراک GameRoute (body: imei|serial, phone?, plan?, duration_days?)
POST /api/v1/partners/oem-sales
feed فروش کارخانه — external_order_id, event_type?, amount_toman?, sku? · idempotent
POST /api/v1/partners/affiliate/convert
تبدیل فروشگاه خارجی — campaign_id|campaign_slug + external_order_id · idempotent
POST /api/v1/partners/events
ingest گیمیفیکیشن — event_type + idempotency_key + phone/email → XP
GET /api/v1/partners/leaderboard?org=ORG_SLUG
لیدربورد عمومی شریک (JSON) — بدون API key · معادل /p/{slug}/leaderboard
GET /api/v1/partners/operator-report?month=2026-07
گزارش اپراتور CSV/JSON — partner_access
POST /api/b2b/entry-batch-request
درخواست batch کد ورود تورنومنت — session شریک · CSV پس از تأیید ادمین
پورتال: /business · OEM: /business/oem · افیلیت: /business/affiliate · ترک: /a/{slug} · لایو CTA: /api/b2b/live-cta/{id}
نمونه curl
curl -H "Authorization: Bearer pk_test_YOUR_KEY" \
"https://nexgaming.ir/api/v1/status?game=valorant"
# GraphQL GameTrends warehouse (subset + field selection)
curl -X POST -H "Authorization: Bearer pk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"{ trendingGames { gameId rank growthPct } }"}' \
"https://nexgaming.ir/api/v1/graphql"
# OEM sales webhook
curl -X POST -H "Authorization: Bearer pk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"external_order_id":"ORD-1","event_type":"sale","amount_toman":1500000}' \
"https://nexgaming.ir/api/v1/partners/oem-sales"
# Affiliate external convert
curl -X POST -H "Authorization: Bearer pk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_slug":"spring","external_order_id":"EXT-1","amount_toman":250000}' \
"https://nexgaming.ir/api/v1/partners/affiliate/convert"
# Custom domain lookup
curl "https://nexgaming.ir/api/v1/partners/domain?host=lb.partner.com"ویجت Embed
<script src="https://nexgaming.ir/widget.js"
data-game="valorant"
data-width="320"
data-height="140"></script>یا iframe: /embed/game/valorant · /embed/health
دسترسی سازمانی
ورود به پورتال کسب‌وکار برای SLA، GameTrends و مدیریت کلید API.