راهنمای Rest Api موبیتس برای اتصال اپلیکیشن های خارجی

اگر یک اپ اندروید و یا ios دارید و قصد دارید از سیستم ورود موبیتس استفاده نمایید، با استفاده از Rest Api موبیتس این کار قابل انجام می باشد.

با استفاده از این ابزار می توانید کاربر را با ارسال پیامک و یا ایمیل، احراز هویت نموده و اکسس توکن دریافت نمایید.

برای ارسال درخواست های api به endpoint های موبیتس، باید از منوی آزمایشگاه و زیرمنوی رابط rest وضعیت رابط api را فعال نمایید.

سپس کلید api را از همان صفحه دریافت نموده و در هدر تمام درخواست ها با نام DLR_REST_API_KEY ارسال نمایید.

مراحل ورود و ثبت نام کاربر با otp

مرحله اول: ارسال نام کاربری

به آدرس زیر یک درخواست ارسال می کنید و دو متغیر username و country_code را ارسال می نمایید:

Headers:
DLR_REST_API_KEY: //Api Key

Body:
local_username: mobile or email
country_code: 98

Url:
yoursite.com/wp-json/dlr/api/usernameCheck

Method:
Post

Results:
Error
or success
{
    "code": "valid_data",
    "message": "داده های معتبر",
       "data": {
        "status": 200,
        "token": "bd0993a935b110abd4b29b48089a4e5a0727963763", //توکن موقت برای ارسال در درخواست بعدی
        "time": 120 //زمان باقی مانده تا انقضای کد تایید
    }
}

مرحله دوم: ارسال کد تایید

پس از تایید شدن کاربر در مرحله اول، درخواست زیر را برای ارسال کد تایید به شماره موبایل و یا ایمیل ارسال می نمایید:

Headers:
DLR_REST_API_KEY: //Api Key

Body:
local_username: mobile or email //موبایل یا ایمیل ارسالی در درخواست قبلی
country_code: 98
token: token //توکن موقت دریافت شده در درخواست قبلی

Url:
yoursite.com/wp-json/dlr/api/sendCode

Method:
Post

Results:
Error
or success (void)

مرحله سوم: اعتبارسنجی کد تایید

اکنون باید کد تایید دریافت شده از کاربر را در این درخواست ارسال نمایید تا صحت سنجی صورت گیرد:

Headers:
DLR_REST_API_KEY: //Api Key

Body:
local_username: mobile or email //موبایل یا ایمیل ارسالی در درخواست قبلی
country_code: 98
code: code //کد تایید دریافت شده از کاربر

Url:
yoursite.com/wp-json/dlr/api/codeCheck

Method:
Post

Results:
Error
or success 
if user exists:
{
    "code": "success_login",
       "data": {
        "status": 200,
        "access_token": ..., //اکسس توکن کاربر معتبر
        "token_type": 'bearer'
    }
}

if user not exists
{
    "code": "success_register",
       "data": {
        "status": 200,
        "access_token": ..., //اکسس توکن کاربر معتبر
        "token_type": 'bearer'
    }
}

ورود با شماره موبایل/ایمیل و رمز عبور

به آدرس زیر یک درخواست پست ارسال می کنید و سه متغیر نام کاربری، کدکشور و رمز عبور را ارسال می نمایید:

Headers:
DLR_REST_API_KEY: //Api Key

Body:
local_username: mobile or email
country_code: 98
password: password

Url:
yoursite.com/wp-json/dlr/api/usernameCheck

Method:
Post

Results:
Error
or success
{
    "code": "success_login",
    "data": {
        "status": 200,
        "access_token": $access_token, //اکسس توکن برای درخواست های بعدی
        "token_type": bearer
    }
}

پس از ورود یا ثبت نام موفق یک اکسس توکن دریافت می کنید که لازم است در درخواست های بعدی در هدر Authentication به صورت زیر قرار دهید:

Authorization: Bearer access_token

سپس در کالبک rest های خود این اکسس توکن را دریافت کرده و با استفاده از تابع زیر، کاربر جاری را بدست آورید:

dlr_get_user_by_rest_api_token ($access_token)