Page History

...

مقدار ramaining_wrong_attemp نیز تعداد خطای ممکن ثبت‌نام/تطابق چهره را مشخص می‌کند.

مقدار next_page_action در صورت true بودن is_enrolled برابر/authenticate/face-detection/zoom-id و در غیر این صورت برابر /authenticate/face-detection/register خواهد بود

نمونه پاسخ موفق در صورت enrolled نبودن:

{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/zoom-idregister",
    "next_page_data": {
        "zoomid": {
            "is_enrolled": false,
            "remaining_wrong_attempt": 3
        }
    },
    "ready_for_final_authenticate": false
}

نمونه پاسخ ناموفقموفق در صورت enrolled بودن:

{
    "next_page": "loginzoomid",
    "next_page_action": "/authenticate/first-pageface-detection/zoom-id",
    "next_page_data": {
        "loginzoomid": {
            "useris_infoenrolled": {true,
                "loaremaining_wrong_attempt": "LEVEL_3_1",
        }
    },
    "fieldsready_for_final_authenticate": false
}

نمونه پاسخ ناموفق (در صورتی که فراخوانی سرویس zoomid با خطای Timeout مواجه شود):

{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/zoom-id-init",
          "mobile_number"next_page_data": {
        "zoomid": {
               "priority"remaining_wrong_attempt": 1,3
        }
    },
    "ready_for_final_authenticate": false,
       "valueerror": "09190019974",{
        "reason": "سرور تشخیص چهره در دسترس نیست"
    }
}

نمونه پاسخ ناموفق (در صورتی که فراخوانی سرویس zoomid با خطای ناشناخته مواجه شود):

{
      "statusnext_page": "hiddenerror",
                    },
    "ready_for_final_authenticate": false,
                "national_number"error": {
                        "priorityreason": 2,
"خطا در فراخوانی سرویس تشخیص چهره"
    }
}

سرویس ثبت نام zoom-id

آدرس: /authenticate/face-detection/register

توضیح: این سرویس در صورتی مورد استفاده قرار می‌گیرد که در پاسخ zoom-id-init مقدار is_enrolled برابر false باشد و نیاز به ثبت نام کاربر باشد. تاریخ تولد و سریال کارت ملی کاربر در بدنه این درخواست قرار می‌گیرند.

بدنه درخواست: به صورت application/x-www-form-urlencoded شامل: تاریخ تولد با نام birth_date به صورت timestamp و سریال کارت ملی با نام national_serial به صورت رشته. 

متد: POST

محتوای پاسخ: در صورتی که is_enrolled در پاسخ true باشد به معنی موفقیت در ثبت نام کاربر است. در صورت خطا هم remaining_wrong_attempt تعداد خطای ممکن باقی‌مانده را مشخص می‌کند.

نمونه پاسخ موفق:

{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/zoom-id",
    "next_page_data": {
        "zoomid": {
            "is_enrolled": true,
            "remaining_wrong_attempt": 3
        }
    },
    "ready_for_final_authenticate": false
}

نمونه پاسخ ناموفق در صورت تطابق نداشتن اطلاعات کاربر:

{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/register",
    "next_page_data": {
        "zoomid": {
            "is_enrolled": false,               "value": "1990619746",
                        "status": "hidden"
            "remaining_wrong_attempt": 2
        }
    },
    "ready_for_final_authenticate": false,
    "error": {
        "reason": "اطلاعات کاربر تطابق }ندارند"
    }
}

نمونه پاسخ ناموفق در صورت بیش از حد اشتباه وارد کردن اطلاعات کاربر با کد ۴۲۲ که در این حالت کاربر باید به آدرس موجود در پاسخ هدایت شود:

{
    "redirect_address": "http://divar.com:9000/buy?error=too_many_attempt"
}

سرویس احراز هویت zoom-id

آدرس: /authenticate/face-detection/zoom-id

توضیح: این سرویس برای تعیین وضعیت احراز هویت کاربر پس از فراخوانی سرویس تطابق چهره توسط ماژول zoomid استفاده می‌شود. در callback فراخوانی سرویس تطابق چهره ماژول zoomid، با فراخوانی این سرویس وضعیت احراز هویت کاربر بررسی می‌شود.

بدنه درخواست: ندارد

متد: POST

محتوای پاسخ: در صورتی که از قبل کاربر با موفقیت سرویس تطابق چهره را فراخوانی کرده باشد، مشابه سایر سرویس‌های احراز هویت، مقدار ready_for_final_authentication با مقدار true برگردانده می‌شود. در غیر این صورت هم مقدار emaining_wrong_attempt تعداد خطای ممکن باقی‌مانده را مشخص می‌کند.

نمونه پاسخ موفق:

{
    "next_page": "zoomid",
    "next_page_action": "/login",
    "ready_for_final_authenticate": true
}

نمونه پاسخ ناموفق در صورتی که چهره کاربر تطابق نداشته باشد:

{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/zoom-id",
    "next_page_data": {
        }
            },
            "client_info": {
                "scope_titles": "تلفن همراه",
                "client_name": "ديوار",
                "client_id": "divar"
            },
            "general_info": {
                "download_address": "/download",
                "deprecate_address": "/deprecate"
            }
 "zoomid": {
      }
    },
    "ready_for_final_authenticateis_enrolled": falsetrue,
    "error": {
        "reason": "خطا در فراخوانی سرویس تشخیص چهره""remaining_wrong_attempt": 3
        }
    }
}

سرویس zoom-id

آدرس: /authenticate/face-detection/zoom-id

توضیح: این سرویس در دو حالت مورد استفاده قرار می‌گیرد.

یک) برای ثبت نام کاربر: در صورتی که در پاسخ zoom-id-init مقدار is_enrolled برابر false باشد و نیاز به ثبت نام کاربر باشد، تاریخ تولد و سریال کارت ملی کاربر در بدنه این درخواست قرار می‌گیرند.

دو) برای تعیین وضعیت کاربر پس از فراخوانی سرویس تطابق چهره توسط ماژول zoomid: در callback فراخوانی سرویس تطابق چهره ماژول zoomid، با فراخوانی این سرویس وضعیت احراز هویت کاربر بررسی می‌شود.

بدنه درخواست:

در حالت یک) دارد به صورت application/x-www-form-urlencoded

در حالت دو) ندارد

...

,
    "ready_for_final_authenticate": false
}

نمونه پاسخ ناموفق در صورت اتمام تلاش‌های ممکن برای تطابق چهره با کد ۴۲۲ که در این حالت کاربر باید به آدرس موجود در پاسخ هدایت شود:

{
    "redirect_address": "http://divar.com:9000/buy?error=too_many_attempt"
}