API رسمی ورزشفا به شما اجازه میدهد اخبار، نتایج زنده، آمار بازیکنان و رتبهبندی لیگها را در اپلیکیشن خود ادغام کنید.
برای استفاده از API، ابتدا یک حساب توسعهدهنده ایجاد کرده و توکن دسترسی دریافت کنید. Base URL تمامی درخواستها به صورت زیر است:
https://api.varzeshfa.ir/v1یک درخواست ساده برای دریافت آخرین اخبار:
curl https://api.varzeshfa.ir/v1/news \
-H "Authorization: Bearer YOUR_API_KEY"تمامی درخواستها باید شامل هدر Authorization به صورت Bearer باشند.
Authorization: Bearer vrz_live_a8d9f7e6.../v1/newsفهرست آخرین اخبار. پارامترهای پشتیبانیشده: limit, category, page
/v1/news/{id}جزییات یک خبر مشخص بر اساس شناسه
/v1/matchesفهرست مسابقات. پارامتر status میتواند live | scheduled | finished باشد
/v1/matches/{id}/eventsرویدادهای زنده یک مسابقه شامل گل، کارت و تعویض
/v1/leagues/{id}/standingsجدول ردهبندی یک لیگ مشخص
/v1/players/{id}مشخصات و آمار یک بازیکن
/v1/webhooksثبت آدرس Webhook جدید برای دریافت رویدادهای زنده
/v1/webhooks/{id}حذف یک Webhook ثبتشده
دریافت آخرین اخبار:
GET /v1/news?limit=20&category=transfer
200 OK
{
"data": [
{
"id": "ne-005",
"title": "...",
"publishedAt": "2026-05-26T10:00:00Z"
}
],
"page": 1,
"total": 132
}دریافت نتایج زنده:
GET /v1/matches?status=live
200 OK
{
"data": [
{
"id": "mt-002",
"minute": 67,
"homeScore": 2,
"awayScore": 1
}
]
}برای دریافت رویدادهای زنده مانند گل، کارت قرمز و... میتوانید آدرس Webhook خود را در پنل توسعهدهندگان ثبت کنید.
POST https://your-app.com/webhook
{
"event": "match.goal",
"matchId": "mt-002",
"minute": 67,
"playerId": "pl-haaland"
}برای دریافت کلید API یا گزارش مشکل با ایمیل dev@varzeshfa.ir در تماس باشید.