/user/:ids

Введение

Добро пожаловать в публичный API SaiEnterprises

Чтобы воспользоваться API, нужно делать запросы по одному из адресов:

https://api.saienterprises.ru/

В конец адреса нужно добавить имя метода с данными (если есть). Список методов размещен ниже. При вызове методов могут возникать ошибки, с ними можно ознакомиться в разделе Ошибки.

Удобство разработки

Чтобы было удобнее смотреть ответ сервера, можете установить расширение для Chrome - JSON Formatter. Оно будет форматировать JSON в человекочитаемый вид, так что можно будет прямо из браузера тестировать методы и сразу смотреть на результат.

Ошибки

Основные

Звания игроков

ID звания	Звание	Цена	Цвет
PRIVATE	Рядовой		#aca8ad
PRIVATE_FIRST_CLASS	Еврейтор	10	#fffeff
LANCE_CORPORAL	Младший сержант	25	#fffeff
SERGEANT	Сержант	40	#fffeff
SENIOR_SERGEANT	Старший сержант	55	#fffeff
ENSIGN	Прапорщик	70	#03029b
SENIOR_ENSIGN	Старший прапорщик	85	#239a9e
LIEUTENANT	Лейтенант	100	#a801a7
SENIOR_LIEUTENANT	Старший лейтенант	150	#97080c
CAPTAIN	Капитан	200	#5f5cc2
MAJOR	Майор	250	#d770d7
LIEUTENANT_COLONEL	Подполковник	399	#f4f35e
COLONEL	Полковник	699	#83df83
GENERAL	Генерал	999	#ddae44
MARSHAL	Маршал	1799	#60faf9
EMPEROR	Император	3699	#ea5e60

ID режимов

ID	Название
BEDWARS	Бед Варс
FAST_BEDWARS	Быстрый Бед Варс
T_ARCADA	ТАркада
SKY_WARS	Скай Варс
HUNGER_GAMES	Голодные игры
CROCODILE	Крокодил
HIDE_AND_SEEK	Прятки
SPEED_BUILDERS	Спид билдерс
SHEEP_WARS	Овечки
TNT_RUN	ТНТ Ран
ANNEXATION	Аннексия
MURDER_MYSTERY	Тайна убийства
COUNTER_STRIKE	Контр-страйк
BUILD_BATTLE	Битва строителей
MIX_GAME	Микс гейм
DEATH_RUN	Дезран

/v2/servers

Получает онлайн серверов

Возвращает список серверов и их текущий онлайн. Так же идет подсчет суммарного онлайна.

Список может пополнятся. Если возникают проблемы с пингом сервера то его онлайн будет отображаться как "0".

Сервера

 https://api.saienterprises.ru/v2/servers
                    
  {
    "totalOnline": 185746,
    "realms": {
      "VimeWorld": 1565,
      "TeslaCraft": 1007,
      "Cristalix": 4919,
      "Hypixel": 50720,
      "GommeHD": 1254,
      "Сubecraft": 649,
      "Rinaorc": 1008,
      "Minehut": 7908,
      "Universocraft": 977,
      "GotoMineland": 771,
      "Wynncraft": 1315,
      "Hollyworld": 4869,
      "Aternos": 105382,
      "DiamondWorld": 528,
      "Blocksmc": 2874,
    }
  }
  
  
  

/v2/week/:servernames

Получает недельные данные по названию сервера

Параметры

servernames: Названия серверов нужно через запятую. Можно указывать как один, так и несколько.

Возвращает информацию об сервере или нескольких серверах по их servernames. Если серве с заданым servernames не найден, то он не будет показан в ответе.

Если вместо servernames ничего не указывать, то сервер вернем полный список серверов и данных, иначе вернет данных тех серверов что были указаны.

Максимальное количество названий серверов, которые можно указать в одном запросе - 8. Пока это все сервера что есть в списке. Если их будет больше, то на сервер, которого нет в списке, вернет ошибку (Сервер с указанным именем не найден).

Данные о серверах за неделю

           https://api.saienterprises.ru/v2/week
          
                    
  {
    "VimeWorld": [
      {
        "date": "May 29 - Jun 05",
        "avg": 1776,
        "peak": 3098,
        "gain": 185,
        "per_gain": 11.64
      },
      ...
      {
        "date": "Sep 04 - Sep 11",
        "avg": 671,
        "peak": 1459,
        "gain": -302,
        "per_gain": -31.04
      }
    ]
    ...
    "summServersJava": [
      {
        ...
      },
    ]
  }

  

/v2/tesla/profile/:nickname

Получает данные о профиле игрока по его нику

Параметры

nickname: nickname игрока.

Возвращает полные данные профиля игрока.

Если игрок с заданным nickname не найден, то вернется ошибка (Cannot read property 'match' of undefined).

Все параметры касательные времени указаны в Unix формате.

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

 https://api.saienterprises.ru/v2/tesla/profile/KpoJ3yLLIKa
                    
  [
    {
      "type": "Данные профиля",
      "profile": {
        "nickname": "KpoJ3yLLIKa",
        "userID": 33473,
        "avatarImageUrl": "https://teslacraft.org/data/avatars/l/33/33473.jpg?1596892656",
        "additionally": "Верховная власть",
        "ranks": [
          "Император"
        ],
        "rankForum": "Завсегдатай",
        "registration": 1560767825,
        "lastOnline": 1694873489,
        "achievements": "54/163",
        "miniparkur": "240",
        "teslingbal": 8863,
        "clanData": {
          "clan": "ＳｔａｇｅＸ",
          "clanPosition": 59,
          "clanRank": "Вице-лидер",
          "playersClanScore": 11967
        },
        "accountData": {
          "gender": "Мужской",
          "birthday": 1041541200,
          "age": 20,
          "address": "Москва",
          "activity": 1694963940,
          "registration": 1565470800,
          "messages": 1164,
          "points": 190,
          "violationsPoints": 0,
          "positiveRatings": 705,
          "neutralRatings": 47,
          "negativeRatings": 97
        },
        "ratings": {
          "Правильный ответ": {
            "Получено": 0,
            "Выставлено": 0
          },
          ...
          "Бред": {
            "Получено": 79,
            "Выставлено": 91
          },
        },

      }
    }
  ]
  

/v2/tesla/statistic/:nickname/:games

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

Параметры

nickname: nickname игрока.

Дополнительные параметры

games: Выводит статистику указанных игр, если ничего не писать после параметра nickname, то будет выводиться вся статистика. Если вам не нужна полная статистика игрока, пожалуйста, указывайте только нужные вам игры. Игры указываются через запятую, по их id из списка.

Параметр статистики "Время в игре" указывается в Unix формате.

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

 https://api.saienterprises.ru/v2/tesla/statistic/KpoJ3yLLIKa
                    
  {
    "nickname": "KpoJ3yLLIKa",
    "BEDWARS": {
      "Очков": 517265,
      "Побед": 1906,
      "Поражений": 1496,
      "Убийств": 19878,
      "Финальных убийств": 4400,
      "Убийств мобов": 6215,
      "Смертей": 9391,
      "Сыгранных партий": 3464,
      "Сломанных кроватей": 1719,
      "Установлено блоков": 374654,
      "Сломано блоков": 113852,
      "Использовано способностей": 848
    },
    ...
  }
    

/v2/tesla/clanscore/:nickname

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

Параметры

nickname: nickname игрока.

Возвращает количество клановых очков по всем мини-играм, в которые играл запрашиваемый игрок.

Если игрок с заданным nickname не найден, то вернется статистика с нулевыми значениями.

Клановые очки

 https://api.saienterprises.ru/v2/tesla/clanscore/KpoJ3yLLIKa
          
  {
      "nickname": "KpoJ3yLLIKa",
      "totalClanScore": 11967,
      "clanScoreMinigame": {
        "BEDWARS": 10219,
        "BUILD_BATTLE": 3,
        "COUNTER_STRIKE": -1,
        "DEATH_RUN": -79,
        "HUNGER_GAMES": -72,
        "CROCODILE": -26,
        "MIX_GAME": -23,
        "MURDER_MYSTERY": 477,
        "HIDE_AND_SEEK": -1,
        "FAST_BEDWARS": 136,
        "SHEEP_WARS": 2,
        "SKY_WARS": 1276,
        "SPEED_BUILDERS": -1,
        "T_ARCADA": 54,
        "TNT_RUN": -50,
        "ANNEXATION": 42
      },
  }
      
    
  

/v2/tesla/claninfo/:nickname

Получает информацию о клане по любому из его участников

Параметры

nickname: nickname игрока.

Возвращает полную клановую информацию о запрашиваемом игроке, так же информацию о самом клане в котором состоит игрок.

Если игрок с заданным nickname не состоит в клане, то сервер вернет ошибку (Игрок не состоит в клане).

В списке clanMembers идут сначала те игроки, у кого наибольшее количество клановых очков.

Клановая информация

 https://api.saienterprises.ru/v2/tesla/claninfo/KpoJ3yLLIKa
      
  {
    "clan": "ＳｔａｇｅＸ",
    "clanTops": 1,
    "numberOfMembers": 67,
    "clanRatingPoints": 3277545,
    "clanTreasury": 1111675,
    "nickname": "KpoJ3yLLIKa",
    "clanRank": "Вице-лидер",
    "playersClanScore": 11967,
    "clanPosition": 58,
    "clanMembers": [
      "Dread_Lord___",
      "x_Bat9_CaH4e3_x",
      "023",
      "Ran_Mika",
      ...
      "StageX-Bot",
    ]
  }
    
  

/v2/tesla/clanlist

Получает список всех кланов на сервере

Возвращает список всех созданных кланов на сервере. Получает основную информацию о клане

Если происходят изменения в названиях кланов, создание или удаление кланов, список обновляется.

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

 https://api.saienterprises.ru/v2/tesla/clanlist
              
  [
    {
      "clanNumber": 1,
      "clanName": "ＳｔａｇｅＸ",
      "clanScore": 3293868
    },
      ...
    {
      "clanNumber": 832,
      "clanName": "<DZPYT>",
      "clanScore": -15876
    }
  ]
        
      
    

/v2/tesla/games

Получает список всех мини-игр на сервере и возможную статистику по ним

Возвращает список всех режимов на сервере. В ответе представлены id, название и возможная статистика по режиму.

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

 https://api.saienterprises.ru/v2/tesla/games
              
  [
    {
      "id": "BEDWARS",
      "name": "Бед Варс",
      "stats": [
        "Очков",
        "Побед",
        "Поражений",
        "Убийств",
        "Финальных убийств",
        "Убийств мобов",
        "Смертей",
        "Сыгранных партий",
        "Сломанных кроватей",
        "Установлено блоков",
        "Сломано блоков",
        "Использовано способностей",
      ]
    },
      ...
  ]
        
      
    

Общее

Данные

Методы

Введение

Удобство разработки

Ошибки

Основные

Звания игроков

ID режимов

/v2/servers

/v2/week/:servernames

Параметры

/v2/tesla/profile/:nickname

Параметры

/v2/tesla/statistic/:nickname/:games

Параметры

Дополнительные параметры

/v2/tesla/clanscore/:nickname

Параметры

/v2/tesla/claninfo/:nickname

Параметры

/v2/tesla/clanlist

/v2/tesla/games