Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagejs
titlezoom-id-init failed example
{
    "next_page": "login",
    "next_page_action": "/authenticate/first-page",
    "next_page_data": {
        "login": {
            "user_info": {
                "loa": "LEVEL_3_1",
                "fields": {
                    "mobile_number": {
                        "priority": 1,
                        "value": "09190019974",
                        "status": "hidden"
                    },
                    "national_number": {
                        "priority": 2,
                        "value": "1990619746",
                        "status": "hidden"
                    }
                }
            },
            "client_info": {
                "scope_titles": "تلفن همراه",
                "client_name": "ديوار",
                "client_id": "divar"
            },
            "general_info": {
                "download_address": "/download",
                "deprecate_address": "/deprecate"
            }
        }
    },
    "ready_for_final_authenticate": false,
    "error": {
        "reason": "خطا در فراخوانی سرویس تشخیص چهره"
    }
}


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

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

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

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

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

...

شامل: تاریخ تولد با نام birth_date به صورت timestamp و سریال کارت ملی با نام national_serial به صورت رشته. 

متد: POST

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

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

Code Block
languagejs
titlezoom-id register successful example
{
    "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
}

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

Code Block
languagejs
titlezoom-id register failed example
{
    "next_page": "zoomid",
    "next_page_action": "/authenticate/face-detection/zoom-id",
    "next_page_data": {
        "zoomid": {
            "is_enrolled": false,
            "remaining_wrong_attempt": 2
        }
    },
    "ready_for_final_authenticate": false,
    "error": {
        "reason": "اطلاعات کاربر تطابق ندارند"
    }
}