1. Запрос осуществляется может осуществляться как методом FormData (Content-type: application/x-www-form-urlencoded), так и Payload (Content-type: application/json)
2. URL для обработки запросов имя сайта/?option=com_wmartalpha&task=api.methodName
3. Первоначальное получение токена выполняется методом api.init
4. CSRF-токен должен передаваться клиентом в заголовке csrf-token, либо в параметре csrfToken тела запроса. Пример
5. Ответ возвращается в формате JSON

  {
    ok: int,
    errors: [
      {
        error: string,
        type: string
      },
      ...
    ],
    ...
  }

имя сайта/?option=com_wmartalpha&task=api.init

Инициализация сессии, получение токена

имя сайта/?option=com_wmartalpha&task=api.login

Авторизация пользователя

имя сайта/?option=com_wmartalpha&task=api.loginOAuth

Регистрация/авторизация в сторонних сервисах по протоколу OAuth. Результат данного запроса должен собран и отправлен от имени пользователя.

имя сайта/?option=com_wmartalpha&task=api.logout

Завершение сессии пользователя

имя сайта/?option=com_wmartalpha&task=api.recover

Восстановление пароля пользователя. Перед процедурой регистрации необходимо запросить код подтверждения методом api.recoverCheck

имя сайта/?option=com_wmartalpha&task=api.recoverCheck

Получение кода подтверждения для регистрации.

имя сайта/?option=com_wmartalpha&task=api.register

Регистрация пользователя. Перед процедурой регистрации необходимо запросить код регистрации методом api.registerCheck

имя сайта/?option=com_wmartalpha&task=api.registerCheck

Получение кода подтверждения для регистрации.

имя сайта/?option=com_wmartalpha&task=api.passwordChange

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

имя сайта/?option=com_wmartalpha&task=api.profileChange

Регистрация пользователя.

имя сайта/?option=com_wmartalpha&task=api.userinfo

Получение информации о текущем пользователе

имя сайта/?option=com_wmartalpha&task=api.reference

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

имя сайта/?option=com_wmartalpha&task=api.usersFilter

Получить свойства и значения для фильтрации

Объект, описывающий OAuth запрос

  {
    url: string,
    method: string,
    params: {
      param1: value1,
      param2: value2,
      ...
    }
  }

Запрос свойств

{   
  id: int,
  title: string,
  alias: string,
  ?values: [
    {
      id: int,
      value: string,
      alias: string,
      ?count: int,
    },
    ...
  ]
}

Запрос свойств. Планируется, что структура объекта будет общая для всех фильтрующихся элементов. Для свойства необходимо указать id либо алиас.

{   
  ?id: int,
  ?alias: string,
  ?count: bool,
  ?format: string,
}

Запрос выборки по элементам. Для свойства необходимо указать id или алиас. Для значения должен быть задан один или несколько признаков.

{   
  ?props: {
    {
      ?id: int,
      ?alias: string,
      values: [
        {
          ?id: int,
          ?alias: string,
          ?min: float/datetime,
          ?max: float/datetime,
          ?search: string,
          ?value: string
        },
        ...
      ]
    }, 
    ...
  }
  ?search: string,
  ?limit: int,
  ?start: int,
  ?sort: string,
  ?direction: string,
}

Информация о пользователе

  {
    id: int,
    registered: bool,
    ?login: string,
    ?firstname: string,
    ?lastname: string,
    ?fullname: string,
    ?sex: int,
    ?description: string,
    ?subjects: [
      {
        referenceId: int,
        value: string
      },
      ...
    ],
    ?orgINN: string,
    ?orgTitle: string,
    ?country: {
      referenceId: int,
      value: string
    },
    ?region: {
      referenceId: int,
      value: string
    },
    ?locality: {
      referenceId: int,
      value: string
    },
    loginData: [
      {
        type: string,
        login: string
      },
      ...
    ],
  }

 function cookieGet(name) {
    var matches = document.cookie.match(new RegExp(
            "(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
            ));
    return matches ? decodeURIComponent(matches[1]) : undefined;
};
 
function cookieSet(name, value, options) {
    options = options || {};
    var expires = options.expires;
 
    if (!options.path)
        options.path = '/';
 
    if (typeof expires == "number" && expires) {
        var d = new Date();
        d.setTime(d.getTime() + expires * 1000);
        expires = options.expires = d;
    }
    if (expires && expires.toUTCString) {
        options.expires = expires.toUTCString();
    }
 
    value = encodeURIComponent(value);
 
    var updatedCookie = name + "=" + value;
 
    for (var propName in options) {
        updatedCookie += "; " + propName;
        var propValue = options[propName];
        if (propValue !== true) {
            updatedCookie += "=" + propValue;
        }
    }
    document.cookie = updatedCookie;
    return true;
}
 
function request(method,data,func){
    data = JSON.stringify(data); //for Payload
    let csrfToken=cookieGet('csrfToken');
    let xhr = new XMLHttpRequest();
    xhr.open('POST', 'https://fetch.melissa.team/?task=api.'+method);
    xhr.setRequestHeader('csrf-token', csrfToken);
    //xhr.setRequestHeader('Content-type', 'application/x-www-form-urlencoded'); //for FormData
    xhr.setRequestHeader('Content-type', 'application/json;charset=UTF-8'); //for Payload
    xhr.responseType = 'json';
    xhr.withCredentials = true;
    xhr.onload = function() {
      if (xhr.status != 200) {
        console.error('connection error'); 
      } else {
        if(xhr.response.errors){
            if(xhr.response.errors.core==='tooManyRequests'){
                console.error('flood detect. wait ' + xhr.response.data.delay);
                return false;
            }
            if(xhr.response.errors.core==='csrfError'){
                console.error('wrong csrf token');
                return false;
            }
        }
        if(typeof(func)==='function'){
            func(xhr.response);
        }
        if(xhr.response.csrfToken){
            cookieSet('csrf_token', xhr.response.csrfToken);
        }
      }
    };
    xhr.send(data);
}
 
//Инициализация
request('init');
 
//Авторизация
request('login',{login:'a1@lct.su', password:'12345'},data=>{ console.log(data) });
 
//Получение информации о текущем пользователе
request('userinfo','',data=>{ console.log(data) });