ثبت‌نام کاربر

این مثال نحوه استفاده از SDK زربان برای پیاده‌سازی فرآیند ثبت‌نام کاربر را نشان می‌دهد. این مثال نحوه ایجاد یک حساب کاربری جدید را با ارسال درخواست ثبت‌نام به API زربان نمایش می‌دهد.

پیش‌نیازها

قبل از اجرای این مثال، اطمینان حاصل کنید که:

۱. SDK زربان را نصب کرده‌اید:

pip install zarban

۲. به API زربان (محیط تست) دسترسی دارید

نمونه کد

from zarban.wallet.openapi_client.configuration import Configuration
from zarban.wallet.openapi_client.api_client
import ApiClient from zarban.wallet.openapi_client.api
import DefaultApi from zarban.wallet.openapi_client.models import SignUpRequest
from zarban.wallet.openapi_client.exceptions import ApiException

def signup_example(): 
    # Create and configure the Configuration object
    configuration = Configuration(host="https://testwapi.zarban.io")
    # Create an instance of the ApiClient with the configuration
    api_client = ApiClient(configuration)
    # Create an instance of the DefaultApi using the ApiClient
    api_instance = DefaultApi(api_client)
    # Prepare the signup request data
    signup_request = SignUpRequest(
        email="[email protected]",
        password="yourSecuredPassword",
    )
    try:
        # Call the signup API
        api_response = api_instance.auth_signup_post(signup_request)
        print("Confirmation link sent successful!")
        print(f"Message: {api_response.messages}")
    except ApiException as e:
        print(f"Exception when calling DefaultApi->auth_signup_post: {e}")
        print(f"Error message: {e.body}")

if __name__ == "__main__":
  signup_example()

توضیح گام به گام ثبت نام کاربر

۱. وارد کردن ماژول‌های مورد نیاز

from zarban.wallet.openapi_client.configuration import Configuration
from zarban.wallet.openapi_client.api_client
import ApiClient from zarban.wallet.openapi_client.api
import DefaultApi from zarban.wallet.openapi_client.models import SignUpRequest
from zarban.wallet.openapi_client.exceptions import ApiException

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

۲. پیکربندی API Client

configuration = Configuration(host="https://testwapi.zarban.io")
api_client = ApiClient(configuration)

یک شیء پیکربندی با نقطه پایانی API ایجاد می‌کند و کلاینت API را راه‌اندازی می‌کند.

۳. راه‌اندازی نمونه API

api_instance = DefaultApi(api_client)

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

۴. آماده‌سازی درخواست ثبت‌نام

signup_request = SignUpRequest(
    email="[email protected]",
    password="yourSecuredPassword",
)

یک شیء درخواست ثبت‌نام با اطلاعات کاربر ایجاد می‌کند.

۵. ارسال درخواست API

api_response = api_instance.auth_signup_post(signup_request)

درخواست ثبت‌نام را به API ارسال می‌کند و پاسخ را مدیریت می‌کند.

مدیریت پاسخ

این مثال شامل مدیریت خطا با استفاده از بلوک‌های try/except است:

• در صورت موفقیت: پیام تأیید و پیام‌های پاسخ را چاپ می‌کند
• در صورت شکست: ApiException را می‌گیرد و جزئیات خطا را چاپ می‌کند

خروجی مورد انتظار

در صورت ثبت‌نام موفق:

Confirmation link sent successful!
Message: [Confirmation email details...]

در صورت خطا:

Exception when calling DefaultApi->auth_signup_post: [Error details]
Error message: [Detailed error message]

نکات مهم

• "[email protected]" و "yourSecuredPassword" را با اطلاعات کاربری واقعی جایگزین کنید
• این مثال از نقطه پایانی API تست (testwapi.zarban.io) استفاده می‌کند. برای استفاده در محیط تولید، host را متناسباً به‌روزرسانی کنید
• اطمینان حاصل کنید که در محیط تولید، شیوه‌های امنیتی مناسب برای رمز عبور رعایت می‌شود
• API یک ایمیل تأیید به آدرس ایمیل ارائه شده ارسال خواهد کرد

مدیریت خطاها

خطاهای رایج که ممکن است رخ دهند:

• فرمت نامعتبر ایمیل
• رمز عبور الزامات امنیتی را برآورده نمی‌کند
• ایمیل قبلاً ثبت شده است
• مشکلات اتصال به شبکه
• خطاهای سرور API

همچنین ببینید

• مستندات مرجع API
• نکات مهم امنیتی