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/face-detection/firstzoom-pageid",
    "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",
    "mobilenext_page_numberdata": {
            "zoomid": {
            "priorityremaining_wrong_attempt": 1,3
        }
    },
    "ready_for_final_authenticate": false,
       "valueerror": "09190019974",{
        "reason": "سرور تشخیص چهره در دسترس نیست"
    }
}

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

{
      "statusnext_page": "hiddenerror",
    "ready_for_final_authenticate": false,
               },
                    "national_number"error": {
                        "priority"reason": 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": {
    "value": "1990619746",
                        "status": "hidden"
                    }
                }
            },
             "client_infozoomid": {
                "scopeis_titlesenrolled": "تلفن همراه"true,
                "client_name"remaining_wrong_attempt": "ديوار",3
        }
    },
    "ready_for_final_authenticate": false
}

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

{
    "next_pageclient_id": "divarzoomid",
            }"next_page_action": "/authenticate/face-detection/register",
    "next_page_data": {
        "general_infozoomid": {
                "downloadis_addressenrolled": "/download"false,
                "deprecate_address"remaining_wrong_attempt": "/deprecate"2
            }
        }
    },
    "ready_for_final_authenticate": false,

    "error": {
        "errorreason": { "اطلاعات کاربر تطابق ندارند"
    }
}

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

{
    "reasonredirect_address": "خطا در فراخوانی سرویس تشخیص چهره"
    }http://divar.com:9000/buy?error=too_many_attempt"
}

سرویس

...

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

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

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

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

متد: POST

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

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

متد: POST

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

...

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

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

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

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

{
    "ready_for_final_authenticate": false,
    "error": {
        "reason": "اطلاعات کاربر تطابق ندارند"
    }redirect_address": "http://divar.com:9000/buy?error=too_many_attempt"
}