شروع سریع: دریافت کلید API

حساب کاربری شخصی شما: یک موجودی مشترک، تا 3 کلید API، کدهای مارکت‌پلیس و مصرف به‌تفکیک درخواست. در ربات Telegram و در app.oneprovider.dev.

چگونه کار می‌کند

• موجودی و کلیدها در حساب کاربری شخصی شما هستند. این همان حساب کاربری در ربات و در وب‌سایت است.
• شما یک موجودی مشترک را شارژ می‌کنید و خودتان کلید API صادر می‌کنید (به‌طور پیش‌فرض 3 کلید؛ پشتیبانی می‌تواند سقف را بالا ببرد). هر کلید در حد سقف خودش از همین موجودی مصرف می‌کند.
• کلید قدیمی‌تر با موجودی باقی‌ماندهٔ آن، وقتی ربات را باز می‌کنید به حساب کاربری منتقل می‌شود.

باز کردن حساب کاربری

ورود به حساب کاربری و کلید API دو چیز جدا هستند: کلید API همچنان اعتبارنامهٔ درخواست‌های API است، در حالی که ورود فقط برای مدیریت موجودی و کلیدهاست.

شارژ موجودی

1. ربات: «حساب کاربری» ← «شارژ حساب کاربری». وب‌سایت: «موجودی» ← «شارژ».
2. یک بسته یا مبلغ دلخواه از 100 تا 5000 دلار و یک روش پرداخت انتخاب کنید: ارز دیجیتال، کارت‌های بین‌المللی / Apple Pay / Google Pay، SBP / QR. مبلغ نهایی و کارمزدها پیش از پرداخت نمایش داده می‌شوند.
3. از طریق پیوند یا صورت‌حساب پرداخت کنید. موجودی به‌طور خودکار اضافه می‌شود، معمولاً ظرف 1 تا 3 دقیقه.

• SBP/QR. مشتری 3.5% کارمزد می‌پردازد؛ OneProvider 3.5% دیگر را پوشش می‌دهد.
• ارز دیجیتال. 3% کارمزد ارائه‌دهنده اعمال می‌شود، به‌علاوهٔ کارمزد شبکه که مشتری می‌پردازد.

قیمت بسته‌ها در صفحهٔ قیمت‌ها و روش‌های پرداخت در صفحهٔ روش‌های پرداخت است. موجودی منقضی نمی‌شود و اشتراک یا کسر خودکار وجود ندارد. پرداخت کرده‌اید ولی موجودی تغییری نکرده؟ رسید را برای @Oneproviderhelpbot بفرستید.

کد مارکت‌پلیس

از G2A، Plati، G2G یا مشابه آن‌ها خرید کرده‌اید؟ سفارش شما با کدی مانند OP-XXXX-XXXX همراه بوده است. ربات: «بیشتر» ← «فعال‌سازی کد». وب‌سایت: «موجودی» ← فیلد «کد OP». مبلغ سفارش مستقیم به موجودی حساب کاربری می‌رود؛ کلید را خودتان صادر می‌کنید (گام بعد).

صدور کلید

1. ربات: «حساب کاربری» ← «صدور کلید». وب‌سایت: «کلیدها» ← «صدور کلید».
2. یک نام (مثلاً نام کلاینت)، یک سقف مصرف (یا «بدون سقف») و یک مدت تعیین کنید: تا 90 روز، که بعداً قابل تمدید است.
3. کلید را همان لحظه کپی کنید: کلید کامل فقط یک‌بار نمایش داده می‌شود و بعداً فقط با «نمایش» و پس از ورود دوباره در دسترس است.

برای هر کلاینت یا پروژه کلید جداگانه بگیرید: می‌بینید چه کسی چقدر مصرف می‌کند و می‌توانید یک کلید را بدون دست زدن به بقیه متوقف کنید. به‌طور پیش‌فرض می‌توانید 3 کلید داشته باشید (پشتیبانی با درخواست می‌تواند سقف را بالا ببرد)؛ اگر به سقف رسیدید، یکی را حذف کنید — موجودی آن همین حالا در حساب کاربری است و چیزی از بین نمی‌رود.

قالب کلید

کلیدها با sk- شروع می‌شوند و بعد از آن 64 نویسهٔ هگزادسیمال با حروف کوچک می‌آید — مثلاً sk-50e20199...f837fca1. مقدار را یک رشتهٔ بی‌ساختار (opaque) در نظر بگیرید: چیزی در آن برای تجزیه وجود ندارد.

کلید را کجا نگه دارید

• توسعهٔ محلی: یک متغیر محیطی در shell rc یا فایل .env که در .gitignore آمده است.
• CI: محل نگهداری رازهای پلتفرم (GitHub Actions secrets، متغیرهای GitLab CI و مانند آن).
• محیط عملیاتی: یک مدیر راز واقعی — 1Password، AWS Secrets Manager، Doppler، Vault.
• موبایل / مرورگر: هرگز. کلید باید پشت یک پروکسی سروری که خودتان کنترل می‌کنید بماند.

مصرف و موجودی

صفحهٔ «مصرف» در حساب کاربری هر درخواست را با مدل، توکن‌ها و قیمتش فهرست می‌کند و بر اساس کلید قابل فیلتر است. API هم موجودی را برمی‌گرداند: GET /v1/dashboard/balance .

پاداش‌ها

پاداش خوشامدگویی و پاداش اولین شارژ پیشنهادهای تبلیغاتی هستند: ممکن است فقط برای مدتی محدود در دسترس باشند و نه قابل برداشت‌اند و نه قابل بازپرداخت (به شرایط نگاه کنید). پیشنهادهای فعال در حساب کاربری نمایش داده می‌شوند؛ پس از پایان یک پیشنهاد، دیگر نمی‌توان پاداش آن را دریافت کرد.

ارجاع‌ها

در برگهٔ «ارجاع‌ها» در حساب کاربری پیوند شخصی شما قرار دارد. دیگران را دعوت کنید و طبق شرایطی که در حساب کاربری نمایش داده می‌شود پاداش بگیرید. ثبت‌نام از طریق پیوند خودتان پاداشی ندارد.

ادغام حساب‌های کاربری

اگر دو حساب کاربری دارید (مثلاً یکی در Telegram و یکی در وب‌سایت)، به @Oneproviderhelpbot پیام بدهید: پس از آنکه مالکیت هر دو را اثبات کردید، آن‌ها را ادغام می‌کنیم و موجودی و کلیدها در یک حساب کاربری جمع می‌شوند.

توقف، حذف، افشا

• توقف یک کلید را بدون حذف آن متوقف می‌کند؛ «ازسرگیری» دوباره آن را روشن می‌کند.
• حذف کلید را بلافاصله غیرفعال می‌کند و برگشت‌پذیر نیست. موجودی در حساب کاربری می‌ماند.

فعال‌سازی کد مارکت‌پلیس: پرسش‌ها

کد OP-XXXX-XXXX را کجا وارد کنم؟

در ربات Telegram «بیشتر» ← «فعال‌سازی کد» را بزنید. در app.oneprovider.dev «موجودی» را باز کنید و از فیلد «کد OP» استفاده کنید. مبلغ سفارش به موجودی حساب کاربری شما اضافه می‌شود؛ سپس در گام «صدور کلید» بالا کلید صادر کنید.

فعال‌سازی را در redeem.oneprovider.dev انجام می‌دهم. از کدام برگه استفاده کنم؟

«کاربر جدید» با کد و نام کاربری یا ایمیل سفارش شما یک کلید جدید می‌سازد. «کاربر دارای کلید» موجودی کد را به یک کلید sk- قدیمی که از قبل دارید اضافه می‌کند. کد دوم با همان ایمیل کلید جدید دیگری نمی‌سازد: از «کاربر دارای کلید» یا یک ایمیل دیگر استفاده کنید.

بعد از فعال‌سازی کلید را کپی نکردم

همان کد را دوباره در صفحهٔ فعال‌سازی وارد کنید: کلید را پشت یک کلیک برای نمایش دوباره نشان می‌دهد. کلیدهای صادرشده در حساب کاربری پس از ورود دوباره با «نمایش» قابل مشاهده‌اند.

«این کد را پیدا نکردیم»

نویسه‌ها را از نظر غلط تایپی بررسی کنید (کد با OP- شروع می‌شود و بعد دو گروه چهارتایی دارد). کد لغوشده یا متعلق به دیگری هم پیدا نمی‌شود. از مرورگر دیگری دوباره امتحان کنید، سپس با شناسهٔ سفارش مارکت‌پلیس به پشتیبانی پیام بدهید.

آیا می‌توانم برای یک کد بازپرداخت بگیرم؟

معمولاً با ثبت اعتراض (dispute) در مارکت‌پلیسی که از آن خریده‌اید. قوانین خود ما در سیاست بازپرداخت آمده است.