OneProvider

مرجع متدهای API نماینده

همهٔ نقاط پایانی API نماینده فروش OneProvider در یک جدول، هر کدام با دامنه و پرچم idempotency، به‌علاوهٔ پیوند مشخصات OpenAPI 3.1، آمادهٔ درون‌ریزی.

همهٔ متدهای API نماینده فروش در یک جدول، با دسترسی و پرچم Idempotency هر کدام، و پیوند به مشخصات OpenAPI 3.1.

همهٔ مدل‌ها، قابلیت‌ها و قیمت‌ها فهرست مستندات برای عامل‌های هوش مصنوعی: https://oneprovider.dev/docs/llms.txt

Base URL: https://app.oneprovider.dev/partner/v1. مشخصات OpenAPI 3.1 قابل‌خواندن برای ماشین: https://app.oneprovider.dev/partner/v1/openapi.yaml (عمومی، بدون نیاز به توکن).

ستون «Idempotency» متدهایی را نشان می‌دهد که هدر Idempotency-Key را لازم دارند. دسترسی «any» یعنی هر توکن معتبر و «none» یعنی توکن لازم نیست.

متدهای API
متدمسیرScopeIdempotencyکاربرد
GET/meany-توکن، دسترسی‌ها، نماینده فروش.
GET/balanceread-موجودی نماینده فروش، رزروشده، قابل استفاده، قیمت عمده، درگاه‌های شارژ.
GET/balance/transactionsread-تراکنش‌های موجودی (cursor).
POST/balance/topupsbillingالزامیساخت پرداخت شارژ، pay_url را برمی‌گرداند.
GET/balance/topups/{order_id}billing-وضعیت پرداخت خودتان.
GET/pricingread-قیمت عمده، تخفیف، محدودیت‌ها.
GET/modelsread-فهرست مدل‌ها و وضعیت زنده.
GET/customersread-فهرست مشتریان (?external_id=).
GET/customers/{id}read-یک مشتری.
POST/customerskeys-ساخت مشتری.
PATCH/customers/{id}keys-ویرایش نام، یادداشت، مسدودسازی (blocked).
GET/customers/{id}/usageread-مصرف یک مشتری در همهٔ کلیدهای فعالش، به تفکیک روز و مدل (?days=1..90).
GET/keysread-فهرست کلیدها (?status=, ?query=, ?customer_id=).
GET/keys/{id}read-کلید بدون راز، همراه dashboard_url.
GET/keys/{id}/usageread-مصرف روزانه و به تفکیک مدل یک کلید (?days=1..90، پیش‌فرض 30).
POST/keyskeysالزامیصدور کلید؛ راز یک بار برگردانده می‌شود.
POST/keys/bulkkeysالزامیصدور چند کلید یکسان با هم.
PATCH/keys/{id}keys-سقف، انقضا (expires_days/hours) یا تمدید (extend_days/hours)، نام، برچسب مشتری.
DELETE/keys/{id}keys-حذف کلید (200 یا 202).
POST/keys/{id}/topupkeysالزامیافزودن مبلغ به سقف کلید.
POST/keys/{id}/rotatekeysالزامیصدور مجدد کلید: راز جدید، راز قبلی از کار می‌افتد.
POST/keys/{id}/pausekeys-توقف کلید.
POST/keys/{id}/resumekeys-از سرگیری کلید.
POST/orderskeysالزامیسفارش پرداخت‌شدهٔ مشتری: کلید جدید یا شارژ.
GET/ordersread-فهرست سفارش‌ها (?external_order_id=).
GET/orders/{id}read-یک سفارش.
GET/plansread-بسته‌های شما.
POST/plansplans-ساخت بسته.
PATCH/plans/{id}plans-ویرایش بسته.
DELETE/plans/{id}plans-حذف بسته.
GET/code-batchescodes-فهرست دسته‌های کد.
POST/code-batchescodesالزامیساخت دستهٔ کد.
GET/code-batches/{id}codes-یک دسته.
GET/code-batches/{id}/codescodes-کدهای یک دسته (?status=).
POST/code-batches/{id}/revokecodes-ابطال کدهای فعال‌نشده.
GET/codes/{code}codes-وضعیت یک کد.
POST/codes/{code}/redeemcodesالزامیفعال‌سازی کد و تبدیل آن به کلید.
GET/statsread-آمار روزانه (?days=1..90).
GET/auditread-گزارش اقدامات (فیلترهای period، actor، action، q).
GET/botbot-ربات فروش و ربات پشتیبانی (بدون توکن).
GET/settingsread-تنظیمات فروشگاه: نام، راه تماس، برند، پیشوند کلید، پیام مشتری.
PATCH/settingskeys-ویرایش تنظیمات فروشگاه (فقط فیلدهای فرستاده‌شده).
GET/payment-providersbot-روش‌های پرداخت ربات: CryptoBot، xRocket، Platega (بدون توکن)؛ Stars همیشه فعال است.
GET/webhookswebhooks-فهرست وب‌هوک‌ها.
POST/webhookswebhooks-ساخت وب‌هوک؛ راز یک بار نمایش داده می‌شود.
DELETE/webhooks/{id}webhooks-حذف وب‌هوک.
POST/webhooks/{id}/testwebhooks-ارسال رویداد آزمایشی.
GET/webhooks/{id}/deliverieswebhooks-گزارش ارسال‌ها.
GET/openapi.yamlnone-مشخصات OpenAPI 3.1 (عمومی).

قواعد مشترک (صفحه‌بندی، خطاها، محدودیت‌ها) در مجوزدهی و سقف‌ها توضیح داده شده‌اند.

آخرین به‌روزرسانی: 2026-11-08 باگی پیدا کردید؟ @Oneproviderhelpbot