================================================
How to Log In by Scanning a QR Code via SUST API
================================================

v1.0. Written by: Zhang Cheng.

To use this endpoint, first complete the integration described in the
SUST Student Affairs Information System SSO Integration Guide.

1. Integration Endpoints
------------------------

-  Student QR-code login: ``https://zhxg.sust.edu.cn/wap/scan/go``
-  Teacher QR-code login: ``https://zhxg.sust.edu.cn/teacher/scan/go``

2. Parameter
------------

``redirectUrl``: the URL page to redirect to after QR-code login. The
value must include the ``http`` or ``https`` protocol.

The URL must be encoded with ``url_encode``.

Example:

.. code:: text

   https://www.baidu.com?a=1&b=2&c=3

Encoded as:

.. code:: text

   https%3A%2F%2Fwww.baidu.com%3Fa%3D1%26b%3D2%26c%3D3

3. Response
-----------

After QR-code login, the system automatically redirects to
``redirectUrl``.

4. Example
----------

.. code:: text

   https://zhxg.sust.edu.cn/wap/scan/go?redirectUrl=https%3A%2F%2Fwww.baidu.com%3Fa%3D1%26b%3D2%26c%3D3