Содержание

Протокол API для аутентификации пользователей

Domain auth.kokids.org

1. Вход (Создание при отсутствии) пользователя

Эндпоинт: /user/login?id=1&token=12345678901234567890123456789012

Метод: POST

Входные параметры:
Email (обязательный): Электронная почта пользователя.
UserID (обязательный): Уникальный идентификатор пользователя.
Password (обязательный): Пароль пользователя.
Bundle (обязательный): Название пакета приложения.
OSInt (обязательный): Целочисленный идентификатор операционной системы.
GAID (обязательный): Идентификатор устройства Google.
Gaidtype (обязательный)
SDKVerC (необязательный): Версия SDK.

Пример запроса (формат формы):

Email=random000@gmail.com
UserID=random-firebase-user-id000
Password=random-password
Bundle=com.YovoGames.hair
OSInt=1
GAID=Random-Device-ID000
SDKVerC=1.0.0

Возможные ответы:

200 OK: Пользователь успешно создан.
{
    "error": "",
    "token": "exampleToken",
    "message": "User created successfully"
}
200 OK: Вход выполнен успешно.
{
    "error": "",
    "token": "exampleToken",
    "message": "Login successful"
}
400 Bad Request: Отсутствуют обязательные поля.
{
    "error": "Email, UserID, and Password are required"
}
400 Bad Request: Неверный ввод.
{
    "error": "Invalid input"
}
401 Unauthorized: Пользователь не найден или неверный пароль.
{
    "error": "User not found"
}
409 Conflict: Пользователь уже существует.
{
    "error": "User already exists"
}
500 Internal Server Error: Ошибка при создании пользователя.
{
    "error": "Failed to create user"
}

2. Выход пользователя

Эндпоинт: /user/logout?id=1&token=12345678901234567890123456789012
Метод: POST
Входные параметры:

Email (обязательный): Электронная почта пользователя.

Пример запроса (формат формы):

Email=random000@gmail.com

Возможные ответы:

200 OK: Выход выполнен успешно.
{
    "error": "",
    "message": "Logout successful"
}
400 Bad Request: Неверный ввод.
{
    "error": "Invalid input"
}

3. Удаление пользователя

Эндпоинт: /user/delete?id=1&token=12345678901234567890123456789012
Метод: POST
Входные параметры:


Email (обязательный): Электронная почта пользователя.

Пример запроса (формат формы):

Email=random000@gmail.com

Возможные ответы:

200 OK: Пользователь успешно удален.
{
    "error": "",
    "message": "User deleted successfully"
}
400 Bad Request: Неверный ввод.
{
    "error": "Invalid input"
}
500 Internal Server Error: Ошибка при удалении пользователя.
{
    "error": "Failed to delete user"
}