Инструменты пользователя
auth
Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
auth [2025/07/21 08:38] serg |
auth [2025/07/21 12:25] (текущий) serg |
||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| ====== Протокол API для аутентификации пользователей ====== | ====== Протокол API для аутентификации пользователей ====== | ||
| <code>Domain auth.kokids.org</code> | <code>Domain auth.kokids.org</code> | ||
| - | ===== 1. Создание пользователя ===== | + | ===== 1. Вход (Создание при отсутствии) пользователя ===== |
| <code> | <code> | ||
| - | Эндпоинт: /user/create?id=1&token=12345678901234567890123456789012 | + | Эндпоинт: /user/login?id=1&token=12345678901234567890123456789012 |
| Метод: POST | Метод: POST | ||
| Строка 34: | Строка 34: | ||
| "message": "User created successfully" | "message": "User created successfully" | ||
| }</code> | }</code> | ||
| + | <code>200 OK: Вход выполнен успешно. | ||
| + | { | ||
| + | "error": "", | ||
| + | "token": "exampleToken", | ||
| + | "message": "Login successful" | ||
| + | } | ||
| + | </code> | ||
| <code>400 Bad Request: Отсутствуют обязательные поля. | <code>400 Bad Request: Отсутствуют обязательные поля. | ||
| { | { | ||
| "error": "Email, UserID, and Password are required" | "error": "Email, UserID, and Password are required" | ||
| }</code> | }</code> | ||
| + | <code> | ||
| + | 400 Bad Request: Неверный ввод. | ||
| + | { | ||
| + | "error": "Invalid input" | ||
| + | } | ||
| + | </code> | ||
| + | <code> | ||
| + | 401 Unauthorized: Пользователь не найден или неверный пароль. | ||
| + | { | ||
| + | "error": "User not found" | ||
| + | } | ||
| + | </code> | ||
| <code>409 Conflict: Пользователь уже существует. | <code>409 Conflict: Пользователь уже существует. | ||
| { | { | ||
| Строка 50: | Строка 67: | ||
| }</code> | }</code> | ||
| - | ===== 2. Вход пользователя ==== | ||
| - | <code> | ||
| - | Эндпоинт: /user/login?id=1&token=12345678901234567890123456789012 | ||
| - | Метод: POST | ||
| - | Входные параметры: | ||
| - | Email (обязательный): Электронная почта пользователя. | ||
| - | UserID (обязательный): Уникальный идентификатор пользователя. | ||
| - | Password (если есть): Пароль пользователя.</code> | ||
| - | **Пример запроса (формат формы):** | ||
| - | </code> | ||
| - | Email=random000@gmail.com | ||
| - | UserID=random-firebase-user-id000 | ||
| - | Password=random-password</code> | ||
| - | **Возможные ответы:** | ||
| - | <code>200 OK: Вход выполнен успешно. | + | ===== 2. Выход пользователя === |
| - | { | + | |
| - | "error": "", | + | |
| - | "token": "exampleToken", | + | |
| - | "message": "Login successful" | + | |
| - | }</code> | + | |
| - | + | ||
| - | <code>400 Bad Request: Неверный ввод. | + | |
| - | { | + | |
| - | "error": "Invalid input" | + | |
| - | }</code> | + | |
| - | <code>401 Unauthorized: Пользователь не найден или неверный пароль. | + | |
| - | { | + | |
| - | "error": "User not found" | + | |
| - | }</code> | + | |
| - | ===== 3. Выход пользователя === | + | |
| <code> | <code> | ||
| Эндпоинт: /user/logout?id=1&token=12345678901234567890123456789012 | Эндпоинт: /user/logout?id=1&token=12345678901234567890123456789012 | ||
| Строка 106: | Строка 94: | ||
| }</code> | }</code> | ||
| - | ===== 4. Удаление пользователя == | + | ===== 3. Удаление пользователя == |
| <code>Эндпоинт: /user/delete?id=1&token=12345678901234567890123456789012 | <code>Эндпоинт: /user/delete?id=1&token=12345678901234567890123456789012 | ||
auth.1753087113.txt.gz · Последние изменения: 2025/07/21 08:38 — serg
Инструменты страницы
