Текст запроса:

微信扫码登入 (new)

Описание процесса входа в систему с помощью сканирования QR-кода через приложение WeChat.

В тексте описаны:

• процесс установки необходимых зависимостей;
• события socket.io;
• интерфейсы для работы с системой: получения QR-кодов, входа через WeChat, выхода из системы, загрузки аватара пользователя, проверки состояния входа, изменения пароля и получения списка пользователей.

Установка необходимых зависимостей

Для реализации входа с использованием WeChat рекомендуется использовать зависимость socket.io-client@2.3.0. Для этого необходимо выполнить следующую команду:

npm i socket.io-client

Также можно использовать обычный WebSocket.

События socket.io

Интерфейсы

Получение URL QR-кода

Вход через WeChat

Процесс входа через WeChat

Выход из системы

Загрузка аватара пользователя

Успешный ответ:

{
    "status": 1,
    "state": true,
    "msg": "Картинка загружена успешно",
    "imgurl": "https://chst.vip/imgs/headimgurl-1650792836990.png"
}

Проверка состояния входа

Изменение пароля

Ответ при успешном изменении пароля:

{
  "status": 1,
  "state": true,
  "msg": "Пароль изменён успешно"
}

При отсутствии пользователя в системе:

{
  "status": 0,
  "state": false,
  "msg": "Пользователь не найден"
}

При неудачной попытке изменения пароля:

{
  "status": 0,
  "state": false,
  "msg": "Ошибка при изменении пароля"
}

Получение списка всех пользователей

Пример ответа:

{
    "status": 200,
    "state": true,
    "msg": "success",
    "users": [
        {
            "username": "lbw1",
            "nickname": "五五开",
            "roleid": "200"
        },
        {
            "username": "root",
            "nickname": "王者管理员",
            "roleid": "1"
        }
    ]
}

Добавление пользователя

Обязательные параметры:

• username — имя пользователя;
• password — пароль;
• nickname — никнейм.

Необязательный параметр:

• phone — номер телефона.

Обновление информации о пользователе

Параметры:

• unid — идентификатор пользователя;
• username (необязательно) — имя пользователя. Таблица 1. Регистрация пользователя | Поле | Обязательное | Описание | | :--: | :--: | :--:| | username | Да | Имя пользователя | | password | Да | Пароль | | phone | Нет | Номер телефона | | nickname | Да | Никнейм | | roles | Нет | Права доступа |

Таблица 2. Интерфейс регистрации пользователя (устаревший)

Результат успешной регистрации:

{
    "status": 1,
    "state": true,
    "msg": "Регистрация прошла успешно",
    "userInfo": {
        "username": "lbw4",
        "nickname": "Не буду читерить вечно",
        "phone": "1577775772"
    }
}

Результат неудачной регистрации:

{
    "status": 0,
    "state": false,
    "msg": "Имя пользователя уже занято"
}

Модуль разрешений

Добавление роли (только для root)

Получение списка ролей

Результат:
{
  "status": 200,
  "msg": "success",
  "roles": [
    {
      "roleid": "200",
      "roleName": "Сотрудник"
    },
    {
      "roleid": "102",
      "roleName": "Директор"
    },
    {
      "roleid": "103",
      "roleName": "Руководитель"
    },
    {
      "roleid": "1",
      "roleName": "Администратор"
    }
  ]
}

Получение меню разрешений

{
  "status": 200,
  "msg": "успех",
  "roleName": "директор",
  "menuList": [
    {
      "name": "Главная страница управления"
    },
    {
      "name": "Управление учениками",
      "children": [
        {
          "name": "Ученические проекты"
        },
        {
          "name": "Личные данные учеников"
        },
        {
          "name": "Общежития учеников"
        }
      ]
    },
    {
      "name": "Контроль посещаемости"
    },
    {
      "name": "Статистические данные"
    },
    {
      "name": "Мой центр"
    }
  ]
}

VIP-пополнение

1. Получение информации о продуктах VIP

Результат:

[
  {
    "updator": null,
    "updateTime": null,
    "_id": "61277523ad0bdb2ddd70a304",
    "product_id": "20210826190403911",
    "category_id": "20210826182431225",
    "productName": "VIP-пополнение",
    "description": "Эксклюзивный пакет VIP-услуг: VIP-пополнение, VIP-удовольствие, личный консьерж 1:1, неограниченный доступ, неограниченное количество жалоб, эксклюзивное VIP-имя",
    "price": 0.01,
    "inventory": 74,
    "imageUrl": "balabalabala"
  }
]

2. Оформление заказа

Результат:

{
  "status": 200,
  "state": true,
  "order_id": "20210830105149117IhPOnp541908",
  "msg": "Оформление заказа прошло успешно"
}

3. Запуск оплаты

В запросе не указаны параметры. 4. Запрос результатов оплаты

  if (result[0].pay_status === 1) {
            res.send({ status: 200, state: true, msg: "Оплата прошла успешно" })
            return
        } else if (result[0].order_status === 2) {
            res.send({ status: 3002, state: false, msg: "Заказ отменён" })
            return
        } else if (result[0].order_status === 3) {
            res.send({ status: 3003, state: false, msg: "Недействительный заказ" })
            return
        } else if (result[0].order_status === 4) {
            res.send({ status: 3004, state: false, msg: "Транзакция закрыта" })
            return
        }else {
            res.send({ status: 3005, state: false, msg: "Ещё не оплачено" })
        }

7. Модуль магазина

5.1 Модуль категорий

5.1.1 Добавление категории

Ответ успешный

{
    "status": 200,
    "state": true,
    "msg": "Добавление прошло успешно"
}

Ответ на неудачный результат

{
    "status": 1004,
    "state": false,
    "msg": "Категория уже существует, пожалуйста, не добавляйте повторно"
}

5.1.2 Удаление категории (использовать с осторожностью)

Поскольку категория и товар связаны, удаление может привести к неправильному получению товара по категории.

Ответ успешный результат

{
    "status": 200,
    "state": true,
    "msg": "Удаление прошло успешно"
}

Ответ на неудачный результат

{
    "status": 1004,
    "state": false,
    "msg": "err Данные не существуют"
}

5.1.3 Изменение категории

5.1.4 Получение категории

Адрес запроса

/category/getCategory

Ответ успешный результат

{
    "status": 200,
    "state": true,
    "msg": "Получение прошло успешно",
    "data": [
        {
            "updateTime": null,
            "updator": null,
            "_id": "5fed5acfb308240d6037bc13",
            "category_id": "20201231125959413",
            "categoryName": "Транспортные средства",
            "creator": "lbw",
            "createTime": "2020-12-31,12:59:59"
        },
        {
            "updateTime": null,
            "updator": null,
            "_id": "5fed5c45b308240d6037bc19",
            "category_id": "20201231130613547",
            "categoryName": "Косметика",
            "creator": "lbw",
            "createTime": "2020-12-31,01:06:13"
        }
    ]
}

5.2 Модуль товаров

5.2.1 Добавление информации о товаре

5.2.2 Изменение информации о товаре

5.2.4 Удаление товара

5.3 Модуль корзины покупок

5.3.1 Выбор товара в корзине покупок

5.3.2 Получение данных корзины покупок

5.3.3 Удаление товара из корзины покупок

5.3.4 Обновление данных корзины покупок

5.3.5 Добавление товара в корзину покупок

5.4 Модуль заказов

5.4.1 Создание предварительного заказа (заказ автоматически аннулируется через 2 минуты)

Состояние заказа

• order_status: состояние заказа: 0 — не отправлен, 1 — успешно отправлен, 2 — отменён, 3 — недействительный заказ, 4 — закрытая сделка, 5 — возврат.

Статус оплаты заказа

• pay_status: 0 — неоплаченный, 1 — оплаченный.

Статус доставки заказа

• shiping_status: статус доставки: 0 — доставка не начата, 1 — доставка началась, 2 — доставка завершена, 3 — товар в наличии.

5.4.2 Запрос статуса оплаты заказа

5.4.3 Запрос подробной информации о заказе

Можно запрашивать статус оплаты заказа, повторяя запрос. Необходимо указать идентификатор заказа.

5.4.4 Отмена заказа (в разработке)

5.4.5 Удаление заказа

5.4.6 Отправка заказа (в разработке)

Параметры:

8. Оплата

6.1. Оплата с помощью сканирования QR-кода через WeChat Pay

Параметры:

Пример запроса:

axios.post("/pay/payment",{
    appid: "wxed58e834201d0894",
    mch_id: 1568650321,
    order_id: 20201231103338122jnvk4na61h
})

Ответ в случае успешного выполнения запроса:

{
    "status": 200,
    "state": true,
    "msg": "OK",
    "prepay_id": "wx301847582783578da0cb5e1a6f24890000",
    "trade_type": "NATIVE",
    "code_url": "weixin://wxpay/bizpayurl?pr=hPUTMw4zz"
}

С помощью code_url можно создать QR-код для оплаты.

6.2. Проверка статуса платежа по заказу

• Описание: Подходит для прямых платежей (режим прямого подключения).

• URL запроса: https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/{out_trade_no}

• Метод: GET

• Параметры:

  Параметр	Переменная	Тип [ограничение длины]	Обязательный	Описание
  Идентификатор прямого партнёра	mchid	string[1,32]	Да	Идентификатор, предоставленный платёжной системой WeChat.
  Номер заказа партнёра	out_trade_no	string[1,32]	Да	Внутренний номер заказа в системе партнёра.

• Пример запроса:

  https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/1217752501201407033233368018?mchid=1230000109

• Ответ:

  Параметр	Переменная	Тип [ограничение длины]	Обязательный	Описание
  Идентификатор приложения	appid	string[1,32]	Да	Идентификатор публичного аккаунта или мобильного приложения.
  Идентификатор прямого партнёра	mchid	string[1,32]	Да	Идентификатор, предоставленный платёжной системой WeChat.
  Номер заказа партнёра	out_trade_no	string[6,32]	Да	Внутренний номер заказа в системе партнёра, должен быть уникальным в пределах одного идентификатора партнёра и состоять только из цифр, букв, символов _-*
  Идентификатор платежа WeChat	transaction_id	string[1,32]	Нет	Идентификатор платежа, созданный платёжной системой WeChat.
  Тип транзакции	trade_type	string[1,16]	Нет	Тип транзакции, возможные значения: JSAPI — оплата через публичный аккаунт, NATIVE — оплата с помощью сканирования QR-кода, APP — оплата через мобильное приложение, MICROPAY — оплата с использованием платёжного кода, MWEB — оплата в мобильном приложении, FACEPAY — оплата лицом.
  Статус транзакции	trade_state	string[1,32]	Да	Статус транзакции, возможные значения: SUCCESS — успешная оплата, REFUND — возврат средств, NOTPAY — неоплаченная транзакция, CLOSED — закрытая транзакция, REVOKED — отменённая транзакция (только для платежей с использованием платёжных кодов), USERPAYING — пользователь производит оплату (только для платежей с использованием платёжных кодов).
  Описание статуса транзакции	trade_state_desc	string[1,256]	Да	Описание состояния транзакции.
  Банк	bank_type	string[1,16]	Нет	Обозначение банка в виде строки.
  Дополнительные данные	attach	string[1,128]	Нет	Дополнительные данные, которые передаются без изменений в запросах API и уведомлениях об оплате и могут использоваться как настраиваемые параметры.
  Время завершения оплаты	success_time	string[1,64]	Нет	Время завершения платежа в формате YYYY-MM-DDTHH:mm:ss+TIMEZONE, где YYYY-MM-DD обозначает год, месяц и день, T указывает на начало элемента time, HH:mm:ss обозначает время, а TIMEZONE — часовой пояс (+08:00 обозначает смещение на 8 часов вперёд относительно UTC, то есть соответствует часовому поясу Пекина).

| :-- | :-- | :-- | :--: | :---------------------------------------------------------------------------------------------- | | +Сцена информации | scene_info | объект | Нет | Идентификатор устройства | | | +Информация о скидках | promotion_detail | массив | Нет | Информация о скидках, возвращается в этом поле при использовании скидок. |

Пример ответа

• Пример нормального ответа

{
    "transaction_id": "1217752501201407033233368018",
    "amount": {
        "payer_total": 100,
        "total": 100,
        "currency": "CNY",
        "payer_currency": "CNY"
    },
    "mchid": "1230000109",
    "trade_state": "SUCCESS",
    "bank_type": "CMC",
    "promotion_detail": [{
        "amount": 100,
        "wechatpay_contribute": 0,
        "coupon_id": "109519",
        "scope": "GLOBALSINGLE",
        "merchant_contribute": 0,
        "name": "Скидка на один товар - 6",
        "other_contribute": 0,
        "currency": "CNY",
        "type": "CASHNOCASH",
        "stock_id": "931386",
        "goods_detail": [{
            "goods_remark": "Замечания к товару",
            "quantity": 1,
            "discount_amount": 1,
            "goods_id": "M1006",
            "unit_price": 100
        }, {
            "goods_remark": "Замечания к товару",
            "quantity": 1,
            "discount_amount": 1,
            "goods_id": "M1006",
            "unit_price": 100
        }]
    }, {
        "amount": 100,
        "wechatpay_contribute": 0,
        "coupon_id": "109519",
        "scope": "GLOBALSINGLE",
        "merchant_contribute": 0,
        "name": "Скидка на один товар - 6",
        "other_contribute": 0,
        "currency": "CNY",
        "type": "CASHNOCASH",
        "stock_id": "931386",
        "goods_detail": [{
            "goods_remark": "Замечания к товару",
            "quantity": 1,
            "discount_amount": 1,
            "goods_id": "M1006",
            "unit_price": 100
        }, {
            "goods_remark": "Замечания к товару",
            "quantity": 1,
            "discount_amount": 1,
            "goods_id": "M1006",
            "unit_price": 100
        }]
    }],
    "success_time": "2018-06-08T10:34:56+08:00",
    "payer": {
        "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
    },
    "out_trade_no": "1217752501201407033233368018",
    "appid": "wxd678efh567hg6787",
    "trade_state_desc": "Платёж не удался, пожалуйста, повторите попытку оплаты",
    "trade_type": "MICROPAY",
    "attach": "Пользовательские данные",
    "scene_info": {
        "device_id": "013467007045764"
    }
}

Таблица кодов ошибок (общепринятые коды ошибок)