Authorization: Bearer ACCESS_TOKEN

Вход

POST https://salesenergy.ru/api/v1/auth/login/
Content-Type: application/json

{
  "login": "user@example.com",
  "password": "user-password",
  "client_id": "mobile-app",
  "device_name": "Android phone",
  "platform": "android",
  "app_version": "1.0.0"
}

Пример успешного ответа:

{
  "success": true,
  "data": {
    "token_type": "Bearer",
    "access_token": "eyJ...",
    "expires_in": 900,
    "refresh_token": "session-id.random-secret",
    "refresh_expires_in": 2592000,
    "user": { "user_id": 1, "login": "user@example.com" },
    "corporation_id": 1,
    "permissions": {},
    "active_products": [],
    "is_system_admin": false
  },
  "error": null
}

Обновление токенов

POST https://salesenergy.ru/api/v1/auth/refresh/
Content-Type: application/json

{
  "refresh_token": "CURRENT_REFRESH_TOKEN"
}

При каждом обновлении сервер возвращает новый refresh-токен. Приложение должно атомарно заменить оба сохраненных токена. Повторное использование старого refresh-токена приводит к отзыву сессии.

Текущий пользователь

GET https://salesenergy.ru/api/v1/auth/me/
Authorization: Bearer ACCESS_TOKEN

Метод возвращает профиль пользователя, активную компанию, объект permissions, список active_products и признак системного администратора.

Выход

POST https://salesenergy.ru/api/v1/auth/logout/
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{}

Также можно выполнить выход без access-токена, передав в JSON поле refresh_token.

Основные объекты и методы

Доступ к обьектам осуществляется через API.

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

GET https://salesenergy.ru/api/v1/users/?page=1&limit=25&q=Иванов
Authorization: Bearer ACCESS_TOKEN

{
  "success": true,
  "data": [
    {
      "user_id": 15,
      "login": "ivanov",
      "email": "user@example.com",
      "firstname": "Иван",
      "lastname": "Иванов",
      "active_flag": true
    }
  ],
  "meta": { "page": 1, "limit": 25 },
  "error": null
}

Получение пользователя

GET https://salesenergy.ru/api/v1/users/15/
Authorization: Bearer ACCESS_TOKEN

Пароль, password hash и служебные данные авторизации в ответах не возвращаются. Адрес старого формата /api/v1/user/:id/ больше не используется.

Коды ответа