مستندات API تراکنش و حساب کاربر

ساخت یا بروزرسانی حساب کاربر

با استفاده از این سرویس می‌توانید برای کاربر جدید توکن و کد ارسال کنید یا کد را برای کاربر موجود به‌روز کنید.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action true string 'manage_token' برای ایجاد یا بروزرسانی توکن
phone true string شماره موبایل کاربر (با فرمت 09xxxxxxxxx)
code false string کد ارسالی به کاربر (فقط برای عمل 'display')

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "manage_token",
    "phone": "09123456789"
}

پارامترهای پاسخ

پاسخ به صورت JSON خواهد بود که شامل موفقیت یا خطا است.

{
    "success": true,
    "message": "User created/updated",
    "token": "generated_user_token",
    "code": "123456"
}

نمایش توکن کاربر

برای نمایش توکن کاربر، درخواست را با action 'display_token' و شماره موبایل و کد ارسال کنید.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action true string 'display_token' برای نمایش توکن
phone true string شماره موبایل کاربر
code true string کد ارسالی به کاربر

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "display_token",
    "phone": "09123456789",
    "code": "123456"
}

پارامترهای پاسخ

{
    "success": true,
    "token": "existing_user_token"
}

تاریخچه درخواست‌ها

این سرویس به شما اجازه می‌دهد تا تاریخچه درخواست‌های کاربر را بر اساس توکن کاربر مشاهده کنید.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action false string نوع عمل ('success' برای درخواست‌های موفق، 'error' برای درخواست‌های ناموفق، 'all' برای همه درخواست‌ها)

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "all"  // Optional
}

پارامترهای پاسخ

پاسخ به صورت JSON خواهد بود که شامل تاریخچه درخواست‌ها است.

{
    "error": false,
    "data": [
        {
            "id": 1,
            "user_token": "your_user_token_here",
            "status_code": 200,
            "request_time": "2024-11-07 12:00:00",
            "message": "Request successful"
        },
        {
            "id": 2,
            "user_token": "your_user_token_here",
            "status_code": 400,
            "request_time": "2024-11-07 12:05:00",
            "message": "Invalid input"
        }
    ]
}

اطلاعات حساب کاربر

این سرویس برای دریافت اطلاعات حساب کاربر استفاده می‌شود.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action true string 'account_info' برای دریافت اطلاعات حساب

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "account_info"
}

پارامترهای پاسخ

{
    "success": true,
    "user": {
        "token": "your_user_token_here",
        "balance": 5000.0,
        "created_at": "2024-01-01 12:00:00"
    }
}

ایجاد تراکنش

این سرویس برای ایجاد یک تراکنش جدید استفاده می‌شود.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action true string 'create_transaction' برای ایجاد تراکنش
amount true float مبلغ پرداختی

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "create_transaction",
    "amount": 1000.0
}

پارامترهای پاسخ

{
    "success": true,
    "message": "Transaction created",
    "transaction": {
        "status": "success",
        "amount": 1000.0
    }
}

تاریخچه پرداخت‌ها

این سرویس برای دریافت تاریخچه پرداخت‌های کاربر استفاده می‌شود.

POST

https://estelamyar.com/token_manager/

پارامترهای درخواست

پارامتر ضروری نوع جزئیات
user_token true string توکن کاربر
action true string 'payment_history' برای دریافت تاریخچه پرداخت‌ها

نمونه JSON ارسالی برای این پایانه

{
    "user_token": "your_user_token_here",
    "action": "payment_history"
}

پارامترهای پاسخ

{
    "error": false,
    "data": [
        {
            "id": 1,
            "user_token": "your_user_token_here",
            "amount": 1000.0,
            "status": "success",
            "created_at": "2024-11-07 12:00:00"
        }
    ]
}