API GCTrade
GCTrade разрабатывается максимально открыто и доступно, API является ключом к пониманию данного механизма. Абсолютно вся публичная информация о магазинах, ценах, аукционах является легко доступной и может быть использована где угодно и как угодно.
API GCTrade постоянно развивается вместе из самим GCTrade и в случае необходимости ее функционал может быть расширен. Любые предложения или вопросы можно написать мне на форуме.
API GCTrade для работы с магазинами
Данные об одном магазине
GET http://gctrade.ru/api/shops/:alias
{
"alias": "nottingham",
"type": "0",
"name": "ТЦ Ноттингем",
"about": "Магазин строительных материалов.",
"description": "<p>Администратор магазина Aceko.</p><p>При возникновении проблем пишите в игре.</p><p>При желании купить оптом \"Белый Камень\", \"Камень\", \"Бревна\"(всех видов), красителей пишите в ЛС.</p>",
"subway": "Nott",
"x_cord": "-7700",
"z_cord": "-1750",
"image_url": "http://gctrade.ru/images/shop/nottingham_l0cmw.jpg",
"updated_at": "1421590259"
}
Данные обо всех магазинах
GET http://gctrade.ru/api/shops
[
{
"alias": "twix",
"type": "0",
"name": "Гипермаркет TWIX",
"about": "В наших магазинах вы найдете самые разные товары на всякий вкус и достаток, причем иногда на выбор разной цены или количества. Казино порадует вас разнообразием ставок и ценными призами.",
"x_cord": "-7675",
"z_cord": "-915",
"image_url": "http://gctrade.ru/images/shop/twix_Atnkhh.png",
"updated_at": "1421590259"
},
{
"alias": "nottingham",
"type": "0",
"name": "ТЦ Ноттингем",
"about": "Магазин строительных материалов.",
"x_cord": "-7700",
"z_cord": "-1750",
"image_url": "http://gctrade.ru/images/shop/nottingham_l0cmw.jpg",
"updated_at": "1421590259"
},
...
]
Для фильтрации результатов можно использовать запрос следующего вида:
GET http://gctrade.ru/api/shop/search/:name
API GCTrade для работы с номенклатурой товаров
Данные об одном товаре New
GET http://gctrade.ru/api/items/:id
{
"id": "1",
"name": "Камень",
"image_url": "http://gctrade.ru/images/items/1.png"
}
Данные обо всех товарах New
GET http://gctrade.ru/api/items
[
{
"id": "1",
"name": "Камень",
"image_url": "http://gctrade.ru/images/items/1.png"
},
{
"id": "2",
"name": "Трава",
"image_url": "http://gctrade.ru/images/items/2.png"
}
...
]
Для фильтрации результатов можно использовать запрос следующего вида:
GET http://gctrade.ru/api/item/search/:name
Данные о стоимости товаров
GET http://gctrade.ru/api/item/cost
[
{
"id": "1",
"name": "Камень",
"image_url": "http://gctrade.ru/images/items/1.png"
"in_shop": {
"count": "20",
"min": "0.7031",
"avg": "1.12265625",
"max": "1.2500"
}
},
{
"id": "2",
"name": "Трава",
"image_url": "http://gctrade.ru/images/items/2.png"
"in_shop": {
"count": "20",
"min": "0.7031",
"avg": "1.12265625",
"max": "1.2500"
}
}
...
]
Для фильтрации результатов можно использовать запрос следующего вида:
GET http://gctrade.ru/api/item/cost/:name
API GCTrade для работы с товаром
Данные о наличии товара
GET http://gctrade.ru/api/goods/:id
{
"id": "1",
"name": "Камень",
"image_url": "http://gctrade.ru/images/items/1.png"
"in_shop": [
{
"price_sell": "45",
"price_buy": "20",
"stuck": "64",
"shop": {
"name": "Зелёный Гоблин",
"image_url": "http://gctrade.ru/images/shop/546552327400f.png",
"shop_url": "http://gctrade.ru/shop/GreenGoblin"}
}
},
{
"price_sell": "48",
"price_buy": "30",
"stuck": "64",
"shop": {
"name": "ТЦ Ноттингем",
"image_url": "http://gctrade.ru/images/shop/nottingham_l0cmw.jpg",
"shop_url":"http://gctrade.ru/shop/nottingham"
}
},
...
]
}
Данные о наличии всех товаров
GET http://gctrade.ru/api/goods
[
{
"id": "1",
"name": "Камень",
"image_url": "http://gctrade.ru/images/items/1.png"
"in_shop": [
{
"price_sell": "45",
"price_buy": "20",
"stuck": "64",
"shop": {
"name": "Зелёный Гоблин",
"image_url": "http://gctrade.ru/images/shop/546552327400f.png",
"shop_url": "http://gctrade.ru/shop/GreenGoblin"}
}
},
{
"price_sell": "48",
"price_buy": "30",
"stuck": "64",
"shop": {
"name": "ТЦ Ноттингем",
"image_url": "http://gctrade.ru/images/shop/nottingham_l0cmw.jpg",
"shop_url":"http://gctrade.ru/shop/nottingham"
}
},
...
]
},
...
]
Для фильтрации результатов можно использовать запрос следующего вида:
GET http://gctrade.ru/api/goods/search/:name
API GCTrade для работы с пользователями
Получить регионы текущего пользователя Необходима авторизация на GCTrade
GET http://gctrade.ru/api/user/regions
[
{
"name": "GCRC_CrystalCity1",
"rights": [
"full"
],
"coordinates": {
"first": "-5531 63 190",
"second": "-5524 127 214"
}
},
{
"name": "GCRC_BA-Plaza_owner",
"rights": [
"full"
],
"coordinates": {
"first": "-8276 65 -906",
"second": "-8053 127 -898"
}
},
...
]
Получить расположение всех пользователей онлайн
GET http://gctrade.ru/api/user/world
[
{
"username": "Aceko",
"coordinates": "-7540 46 -2092"
},
{
"username": "Aleksandr1977",
"coordinates": "-8044 64 -301"
},
...
]
Получить текущее положение пользователя Пользователь должен быть онлайн
GET http://gctrade.ru/api/user/world/:username
{
"username": "GCMap",
"coordinates": "-10346 1 -2785"
}
Лицо пользователя, на основе его скина GreenCubes
GET http://gctrade.ru/api/user/head/:username
Вывод (изображением) всех GreenCubes значков пользователя
GET http://gctrade.ru/api/user/badges/:login