О ПРОЕКТЕ
ТОРГОВАЯ ПЛОЩАДКА
ПРОФИЛЬ
ВОЙТИ
BlackSteam - API
API
for developers
Общая информация
API позволяет автоматизировать управление предметами Ваших проектов и проводить операции с его помощью.
Методы API доступны после на платформе.
Доступ к API
POST запрос содержащий URL, составленный согласно требованиям операции.
Header содержащий , секретный ключ доступа.

Модули для онлайн игр
Minecraft Plugin v 1.0.7
или

Примеры кода
Пример кода на Java
1
2
3
4
5
6
7
8
9
10
11
12
String addItem() throws IOException {
    URL url = new URL("https://blacksteam.io/api?action=additem&itemid=1&blacksteamid=Bot");
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
    connection.setRequestMethod("POST");
    connection.addRequestProperty("Token", "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX");
    connection.addRequestProperty("User-Agent", "Java");
    connection.connect();
    InputStreamReader is = new InputStreamReader(connection.getInputStream());
    BufferedReader in = new BufferedReader(is);
    return in.readLine();
}
// Функция добавит пользователю Bot один предмет с ID 1 и вернет ответ сервера.


Пример кода на Python
1
2
3
4
5
6
7
def addItem():
    r = requests.post(
        "https://blacksteam.io/api?action=additem&itemid=1&blacksteamid=Bot",
        data = {"token": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"}
    )
    return r.content
// Функция добавит пользователю Bot один предмет с ID 1 и вернет ответ сервера.





Ответ сервера
Пример ответа сервера

JSON:
{"code":
code
}
Код
Описание
Состояние

100
Операция выполнена.
Выполнено

101
Не указан токен.
Неудача

102
Не указана операция.
Неудача

103
Не указан ID предмета.
Неудача

104
Не указан BlackSteamID пользователя.
Неудача

105
Токен не действителен.
Неудача

106
Пользователя с таким BlackSteamID не существует.
Неудача

107
Предмета с таким ID не существует.
Неудача

108
Предмет с таким ID не принадлежит Вашему проекту.
Неудача

109
Не удалось обработать запрос.
Неудача

110
Инвентарь не содержит предмет с таким ID.
Неудача

200
Пользователь идентифицирован.
Выполнено

201
Не указан идентификатор пользователя.
Неудача

202
Идентификатор не действителен.
Неудача

300
Инвентарь получен.
Выполнено

301
В инвентаре нет предметов Вашего проекта.
Неудача





Список операций
1. Идентификация пользователя

Method:
POST

Headers: Token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
URL: https://blacksteam.io/api?action=param1&identifier=param2&blacksteamid=param3
Параметр
Тип данных
Описание
Пример

action
String
Проводимая операция.
validation*

identifier
String
Идентификатор пользователя из настроек профиля.
XXXXXXXX

blacksteamid
String
BlackSteamID пользователя.
Bot
JSON:
{"code":200} // Успешный ответ сервера.
*Фиксированное значение.


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

Method:
POST

Headers: Token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
URL: https://blacksteam.io/api?action=param1&blacksteamid=param2
Параметр
Тип данных
Описание
Пример

action
String
Проводимая операция.
getinv*

blacksteamid
String
BlackSteamID пользователя.
Bot
JSON:
{"code":300,"inv":[1,2,3]} // Успешный ответ сервера.
*Фиксированное значение.


3. Выдать пользователю предмет

Method:
POST

Headers: Token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
URL: https://blacksteam.io/api?action=param1&itemid=param2&blacksteamid=param3
Параметр
Тип данных
Описание
Пример

action
String
Проводимая операция.
additem*

itemid
Integer
ID предмета.
1

blacksteamid
String
BlackSteamID пользователя.
Bot
JSON:
{"code":100} // Успешный ответ сервера.
*Фиксированное значение.


4. Забрать у пользователя предмет

Method:
POST

Headers: Token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
URL: https://blacksteam.io/api?action=param1&itemid=param2&blacksteamid=param3
Параметр
Тип данных
Описание
Пример

action
String
Проводимая операция.
delitem*

itemid
Integer
ID предмета.
1

blacksteamid
String
BlackSteamID пользователя.
Bot
JSON:
{"code":100} // Успешный ответ сервера.
*Фиксированное значение.