API اسپورت‌بوک برای سایت‌های شرط‌بندی و کازینو
رابطی برای تیم‌های فنی که می‌خواهند اسپورت‌بوک را با ظاهر خودشان بسازند.
به‌روزرسانی: 5 اکتبر 2026
API اسپورت‌بوک Nocturn Sport برای اپراتورهایی است که تیم فنی دارند و می‌خواهند بخش پیش‌بینی ورزشی را با رابط کاربری خودشان بسازند. همه داده‌ها و عملیات اصلی یک اسپورت‌بوک پیش از بازی از طریق این API در دسترس است: دریافت رویدادها و ضرایب، ثبت شرط، تاریخچه و موجودی بازیکن.
فید ضرایب: اسنپ‌شات و دلتاها
کلاینت شما در اولین درخواست یک اسنپ‌شات کامل می‌گیرد: همه ورزش‌ها، تورنمنت‌ها، رویدادها، بازارها و گزینه‌ها با ضریب فعلی. هر پاسخ یک شماره نسخه دارد. از آن به بعد، کلاینت حدوداً هر ۱۰ ثانیه با آخرین نسخه‌ای که دارد درخواست می‌دهد و فقط تغییرات (دلتا) را دریافت می‌کند: ضرایب جابه‌جاشده، بازارهای تعلیق‌شده، رویدادهای تازه یا بسته‌شده. این روش حجم انتقال داده را پایین نگه می‌دارد و همگام‌سازی را ساده می‌کند. ساختار فید در صفحه فید ضرایب شرح داده شده است.
ثبت شرط
- تکی و میکس: کوپن میکس تا حداکثر تعدادی که شما تعیین می‌کنید (حداکثر ۱۰)، با یک انتخاب از هر رویداد.
- شناسه درخواست (Request ID): هر ثبت شرط شناسه یکتا دارد، پس اگر شبکه قطع شود و درخواست دوباره ارسال شود، شرط دو بار ثبت نمی‌شود.
- اعتبارسنجی: بسته بودن بازار، تغییر ضریب، سقف مبلغ و سقف پرداخت پیش از پذیرش بررسی می‌شود.
تاریخچه و موجودی
API فهرست شرط‌های هر بازیکن را با وضعیت آن‌ها (باز، برنده، بازنده، باطل) برمی‌گرداند و موجودی بازیکن را هم می‌توان از آن خواند. این برای ساختن صفحه «شرط‌های من» و نمایش لحظه‌ای موجودی کافی است.
کنترل‌های بک‌آفیس
کنار API، پنل مدیریت امکانات ریسک را در اختیارتان می‌گذارد: تعلیق یک رویداد، تغییر دستی هر ضریب، ثبت نتیجه، دیدن بدهی احتمالی روی هر بازار، تعیین حداقل و حداکثر ضریب، سقف مبلغ، سقف پرداخت، حداکثر انتخاب در کوپن، زمان بسته شدن پیش از شروع و حاشیه سود.
جریان کار یک کوپن در API
یک مثال ساده: بازیکن در رابط شما دو انتخاب از دو بازی مختلف به کوپن اضافه می‌کند. سیستم شما ضرایب را از آخرین دلتای فید نمایش می‌دهد. با فشردن دکمه ثبت، درخواست با یک شناسه یکتا ارسال می‌شود. پاسخ یا پذیرش شرط است، یا رد آن با دلیل مشخص، مثلاً تغییر ضریب یا بسته شدن بازار. پس از پایان بازی‌ها و ثبت نتیجه در بک‌آفیس، وضعیت کوپن در تاریخچه به‌روز می‌شود و موجودی بازیکن را دوباره می‌خوانید. همه این مراحل بدون نیاز به منطق قیمت‌گذاری در سمت شما انجام می‌شود.
راه‌های اتصال
می‌توانید API را مستقیم به کار ببرید یا از طریق SoftAggregator وصل شوید؛ در این حالت یک یکپارچه‌سازی، بازی‌های کازینو و اسپورت‌بوک را با هم می‌آورد. اگر نمی‌خواهید فرانت‌اند بسازید، نسخه وایت‌لیبل را ببینید. نمای کلی محصول در صفحه نرم‌افزار اسپورت‌بوک است.
مستندات و شرایط همکاری را با تیم ما هماهنگ کنید: از طریق فرم و اطلاعات تماس، ایمیل [email protected] یا تلگرام @mentionso. قیمت با درخواست اعلام می‌شود.
پرسش‌های پرتکرار
کلاینت هر چند وقت باید فید را بخواند؟
حدود هر ۱۰ ثانیه، با ارسال آخرین شماره نسخه. پاسخ فقط تغییرات پس از آن نسخه را شامل می‌شود.
اگر درخواست ثبت شرط دو بار ارسال شود چه می‌شود؟
هر درخواست یک شناسه یکتا دارد. اگر همان شناسه دوباره برسد، سیستم آن را شرط جدید حساب نمی‌کند.
آیا API نتایج و تسویه را هم پوشش می‌دهد؟
نتایج در بک‌آفیس ثبت می‌شوند و وضعیت شرط‌ها در تاریخچه API به‌روز می‌شود.
برای دریافت مستندات با چه کسی تماس بگیرم؟
درخواست خود را به [email protected] بفرستید یا در تلگرام به @mentionso پیام دهید.